Users API
Returns a list of users. Supports pagination, filtering, sorting and simulation. A free mock REST endpoint from DevSeed API for building and testing frontend applications without a real backend.
Base URL
https://www.devseedapi.com/api/v1
Endpoints
GET /users
Returns a list of users. Supports pagination, filtering, sorting and simulation.
GET /users/:id
Returns a single record as { success, data }, or a 404 if the id doesn't exist. Supports the simulation parameters below.
Write endpoints (simulated)
POST /users
PUT /users/:id
PATCH /users/:id
DELETE /users/:id
- Writes behave like a real API but nothing is saved: the response shows the record the write would produce, and later reads are unchanged.
- Send JSON (
Content-Type: application/json) with the same fields as a record.idandcreatedAtare set by the server and ignored if you send them. POSTreturns201.PUTneeds a full record,PATCHonly the fields to change (nested objects are merged), andDELETEreturns the deleted record.- Invalid bodies return
422with anerrorslist (missing or unknown fields, wrong types, ids that point at missing records). An unknown id returns404. The simulation parameters work on writes too.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| page | number | Page number for pagination |
| limit | number | Number of results per page |
| search | string | Search across fields. Supports nested fields (e.g., searches name.first, name.last, email). |
| filter | string | Filter by any field using query params. Supports nested fields using dot notation (e.g., address.city=Toronto, name.first=John). |
| sort | string | Sort by a field. Supports nested fields using dot notation (e.g., sortBy=name.first&order=asc). |
| delay | number (ms) | Simulates network latency |
| error | number (HTTP code) | Force a specific HTTP error |
| errorRate | number (0–100) | Random API failures by percentage |
Example Requests
Get all users
GET /usersGet one by ID
GET /users/u1Pagination
GET /users?page=2&limit=10Search users
GET /users?search=johnFilter users
GET /users?filter=valueSort users
GET /users?sortBy=field&order=ascCreate (simulated)
POST /users
Content-Type: application/json
{ ...fields of a users record }Update fields (simulated)
PATCH /users/u1
Content-Type: application/json
{ ...only the fields to change }Delete (simulated)
DELETE /users/u1Simulate slow API
GET /users?delay=2000Force an error
GET /users?error=500Random API failures (20%)
GET /users?errorRate=20Try the API
Live API Console
/users
Missing a field, filter or endpoint? Was this page helpful?
Request an endpoint / give feedback