List Accounts

List customer accounts visible to the public API principal.

GET /v1/public/accounts

List Accounts

cURL

curl --request GET \
  --url https://api.hybridbox.io/v1/public/accounts \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "client": {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "name": "<string>"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "status": "<string>",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "page": 123,
  "page_size": 123,
  "total": 123
}

Authorizations

Authorization · string · header · required

Public API bearer credential sent as Authorization: Bearer <token>. Use either an OAuth access token or a Hybridbox Service account token.

Query Parameters

client_id · string<uuid> | null

status · string | null

page · integer · default: 1

page_size · integer · default: 25

Response

200

application/json

items · AccountResponse · object[] · required

Accounts on this page

Hide child attributes

items. client · AccountClientSummary · object · required

Client that owns the account

Hide child attributes

items.client. id · string<uuid> · required

Client UUID

items.client. name · string · required

Client display name

items. created_at · string<date-time> · required

Account creation timestamp

items. id · string<uuid> · required

Account UUID

items. name · string · required

Account display name

items. status · string · required

Account lifecycle status

items. updated_at · string<date-time> · required

Account last update timestamp

page · integer · required

Current one-based page number

page_size · integer · required

Maximum items per page

total · integer · required

Total matching accounts