GET/api/v6/account/users

Users

Organization members, with role, cost center and status.

Scope and limits

Scope

API key with the directory capability granted

Usage limit

30 requests per minute

  • Pagination with limit (default 20, max 100) and offset (default 0). The response carries data.items and data.pagination.

Organization users (members), with their role, cost center and status. It contains personal data: treat it as such in your own systems.

Pagination with limit (default 20, max 100) and offset (default 0). The response carries data.items and data.pagination.

Includes personal data

The API key must have the directory capability explicitly enabled. Access to all services does NOT grant it. A key without the capability gets 403.

Query parameters

limit
integeroptional
How many items to return (1 to 100).

Default: 20

offset
integeroptional
Where to start from.

Default: 0

status
stringoptional
Optional status filter.

Responses

200

Page of users.

{
  "success": true,
  "data": {
    "items": [
      {
        "userId": 10000,
        "firstName": "Diego",
        "lastName": "Pérez",
        "email": "dev@acme.co",
        "roles": ["owner"],
        "costCenterId": 17,
        "status": "active",
        "joinedAt": "2026-05-14 11:31:56",
        "lastUsedAt": "2026-06-02 09:00:00"
      }
    ],
    "pagination": { "limit": 20, "offset": 0, "returned": 1, "hasMore": false }
  },
  "meta": {
    "requestId": "b9b1704baffab21150213c02fd853975",
    "timestamp": "2026-06-02T19:43:59+00:00",
    "responseTimeMs": 4.1
  }
}
401

Invalid or missing credentials.

403

The API key lacks the required capability, or the organization cannot run the request.

429

Request limit exceeded.

Possible errors

Codes this endpoint can return in error.code. The full detail lives in the catalog.

See the full catalog
GET /api/v6/account/users
curl -X GET 'https://developers.hablame.co/api/v6/account/users' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer hk_YOUR_API_KEY'

Try-It

Run the request against the real API with your own API key.

The key is used only in your browser for this request. It is not stored nor sent anywhere else.

Parameters

How many items to return (1 to 100).

Where to start from.

Optional status filter.

GET https://developers.hablame.co/api/v6/account/users

Response

You have not sent a request yet.