List clients

Every client you have asked for, provisioning and ready, newest first.

GET /clients

List clients

cURL

curl --request GET \
  --url https://api.hevn.finance/dapi/v1/clients \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "id": "cl_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41",
      "status": "provisioning",
      "createdAt": "2023-11-07T05:31:56Z",
      "name": "<string>",
      "email": "<string>",
      "phone": "<string>",
      "baseSmartWallet": "<string>",
      "kybStatus": "notStarted",
      "kybApplicationId": "kyb_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41",
      "failure": {
        "code": "provisioning_failed",
        "message": "<string>",
        "retriable": false
      },
      "pollUrl": "<string>"
    }
  ],
  "nextCursor": "<string>"
}

Authorizations

Authorization · string · header · required

Platform access token from POST /auth/token, carrying the platform audience and the developer_key_id of the registration that minted it. It acts as your own account; name a client you created with X-Hevn-Account: cl_…. Every request re-checks that the registration is still active and that the caller's source IP is inside its allowlist. A token is valid only against the server that issued it, so sandbox tokens are refused in production and production tokens in the sandbox.

Headers

X-Hevn-Account · string | null

The client account to act for, as a cl_… id. Omit it to act as yourself.

Example:

"cl_9f2c1ab84d7e4f1fa3c65b0e7d9a2c41"

x-api-key · string | null

Query Parameters

email · string<email> | null

Exact match, lowercased.

status · enum<string> | null

Available options: provisioning, ready, failed

limit · integer · default: 50

Required range: 1 <= x <= 100

cursor · string | null

Maximum string length: 512

Response

200

application/json

Successful Response

items · ClientResponse · object[] · required

Resources in this page, in stable server-defined order.

Show child attributes

nextCursor · string | null

Opaque cursor for the next page; absent when this is the final page.