Paginated list of users. Supports filtering, range operators (`_gte`, `_lte`, `_gt`, `_lt`, `_ne`, `_like`), full-text search, sorting, field selection, and relation expansion.

Parameters 12

Name	Type	Description
`_page`	query · integer	Page number (1-based)
`_limit`	query · integer	Items per page
`_start`	query · integer	Slice start index (alternative to page-based)

ReturnsUser

Bearer token required

Response examples

200Paginated array of users

application/json example derived from schema

[
  {
    "id": 1,
    "firstName": "Demo",
    "lastName": "User",
    "email": "demo@example.com",
    "username": "demo",
    "avatar": "https://i.pravatar.cc/150?u=demo",
    "phone": "+1-555-000-0001",
    "address": {
      "street": "1 Demo Way",
      "city": "Austin",
      "state": "TX",
      "zipCode": "78701",
      "country": "US",
      "geo": {
        "lat": 30.2672,
        "lng": -97.7431
      }
    },
    "company": {
      "name": "Demo Corp",
      "catchPhrase": "Seeded for docs and testing."
    },
    "website": "https://example.com/demo",
    "role": "admin",
    "age": 30,
    "bio": "Seeded demo account. Log in with any password.",
    "isActive": true,
    "createdAt": "2024-01-01T00:00:00.000Z",
    "updatedAt": "2026-04-21T00:00:00.000Z"
  }
]

429429 — rate limit exceeded (120/60s)

application/json

{
  "error": {
    "status": 429,
    "message": "Too many requests",
    "details": {
      "retryAfter": 45
    }
  }
}

Code examples

curl -H 'Authorization: Bearer <TOKEN>' 'https://api.rodin.dev/mock/users'

fetch("https://api.rodin.dev/mock/users", {
  method: "GET",
  headers: {
      "Authorization": "Bearer <TOKEN>"
    },
})
  .then((response) => response.json())
  .then((data) => console.log(data))

import requests

url = "https://api.rodin.dev/mock/users"
headers = {
    "Authorization": "Bearer <TOKEN>"
}

response = requests.get(url, headers=headers)
print(response.json())

Authentication

AuthenticationBearer token

Paste cURL