Fake groups API

40 groups from the Identity API, a fake user directory API. Departments, teams, roles and offices. member_count follows the memberships.

Reads with filters, sorting, search and relations; writes that answer like a real server and stay in your session token. Same ids on every build. Free, no key, CORS open.

Connect

List: https://api.sondahub.com/v1/identity/groups
One record: https://api.sondahub.com/v1/identity/groups/{id}
OpenAPI 3: https://api.sondahub.com/v1/identity/openapi.json
GraphQL: https://api.sondahub.com/v1/identity/graphql
JSON file: https://api.sondahub.com/data/identity/groups.json
MCP: https://api.sondahub.com/mcp · list_records

The first three groups

curl "https://api.sondahub.com/v1/identity/groups?limit=3"

Sample records

Records 1 to 3 of 40, exactly as GET /v1/identity/groups/{id} answers them. The data file holds all of them.

[
  {
    "id": 1,
    "created_at": "2024-04-27T17:43:20Z",
    "updated_at": "2024-04-27T17:43:20Z",
    "display_name": "Engineering",
    "slug": "engineering",
    "kind": "department",
    "description": "Everyone in Engineering.",
    "external_id": "grp-ug7b77y4",
    "member_count": 109
  },
  {
    "id": 2,
    "created_at": "2025-06-29T08:50:47Z",
    "updated_at": "2025-06-29T08:50:47Z",
    "display_name": "Product",
    "slug": "product",
    "kind": "department",
    "description": "Everyone in Product.",
    "external_id": "grp-gws33mc4",
    "member_count": 29
  },
  {
    "id": 3,
    "created_at": "2023-10-20T10:03:19Z",
    "updated_at": "2023-10-20T10:03:19Z",
    "display_name": "Design",
    "slug": "design",
    "kind": "department",
    "description": "Everyone in Design.",
    "external_id": "grp-j2ug5c58",
    "member_count": 15
  }
]

Fields

Field	Type	Notes
`id`read-only	int	Assigned by the server. Seed records keep their ids across restarts; records you create continue after the seed.
`created_at`read-only	datetime	When the record was created (ISO 8601, UTC).
`updated_at`read-only	datetime	When the record last changed.
`display_name`required	string
`slug`	string
`kind`	enum	`department` `team` `role` `office` `list`
`description`	text
`external_id`	string
`member_count`read-only	int

Relations: memberships → the memberships whose group_id is this group. Use ?expand=memberships to embed them, or the nested routes.

Endpoints

GET/v1/identity/groupsA page, with every filter, sort, search, field and expand option.

POST/v1/identity/groupsCreate one: 201 with the record, its id, a Location header and the session token that keeps it; 422 names each field that is wrong.

GET/v1/identity/groups/{id}One record, with an ETag; If-None-Match earns a 304.

PATCH/v1/identity/groups/{id}Change the fields you send.

PUT/v1/identity/groups/{id}Replace the record; required fields must all be there.

DELETE/v1/identity/groups/{id}Answers 200 with what was removed (a real server’s 204 lives at /v1/utils/status/204); gone for the session.

GET/v1/identity/groups/{id}/membershipsIts memberships, as a page with all the list options.

Try it

List with a filter

curl "https://api.sondahub.com/v1/identity/groups?kind=team&limit=3"

One record

curl https://api.sondahub.com/v1/identity/groups/1

Its memberships

curl "https://api.sondahub.com/v1/identity/groups/1/memberships?limit=5"

Create

curl -i -X POST https://api.sondahub.com/v1/identity/groups \
  -H "Content-Type: application/json" \
  -d '{"display_name":"Platform Team","slug":"platform-team","kind":"team"}'

Read it back: newest first (send the session token)

curl "https://api.sondahub.com/v1/identity/groups?sort=-id&limit=3" \
  -H "X-Sondahub-Session: THE_TOKEN_FROM_THE_CREATE"

Change one field

curl -X PATCH https://api.sondahub.com/v1/identity/groups/1 \
  -H "Content-Type: application/json" \
  -d '{"kind":"team"}'

Delete the one you created

curl -X DELETE https://api.sondahub.com/v1/identity/groups/41 \
  -H "X-Sondahub-Session: THE_TOKEN_FROM_THE_CREATE"

Query recipes

Every list option works on groups; these are ready to paste. All the options.

What	Request
Page 2, 50 at a time (of 40)	/v1/identity/groups?page=2&limit=50
Only kind = department	/v1/identity/groups?kind=department
Newest first by created at	/v1/identity/groups?sort=-created_at&limit=5
Display name contains “engine”	/v1/identity/groups?display_name_like=engine
Full-text search	/v1/identity/groups?q=engine
Only some fields	/v1/identity/groups?fields=id,display_name&limit=5
Its memberships (nested route)	/v1/identity/groups/1/memberships?limit=5
Just the count	/v1/identity/groups?limit=1&fields=id

GraphQL

The same groups as the groups query on https://api.sondahub.com/v1/identity/graphql, and one group as group(id: 1). Introspection is on. More on the GraphQL API.

{
  groups(limit: 3, sort: "-id", filter: { kind: department }) {
    total
    data {
      id display_name slug kind
      memberships(limit: 2) { id }
    }
  }
}

Run it

curl https://api.sondahub.com/v1/identity/graphql -H "Content-Type: application/json" -d '{"query": "{ groups(limit: 3, sort: \"-id\", filter: { kind: department }) { total data { id display_name slug kind memberships(limit: 2) { id } } } }"}'

From an AI agent (MCP)

The MCP server reaches the same rows with list_records, get_record, create_record, update_record and delete_record, and as the resource sondahub://identity/groups.

tools/call

curl https://api.sondahub.com/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_records","arguments":{"api":"identity","collection":"groups","filters":{"kind":"department"},"limit":3}}}'

More in the Identity API

users (300) · memberships (1,457)

The live streams, and the whole API on one page: Identity API. Other worlds: fake e-commerce API, fake IoT API, fake banking API, fake social media API, fake helpdesk API, fake flight booking API.