Skip to main content
Salfio Docs

Search documentation

Type to search this documentation.

On this pageOverview

Get a client

Fetch a single client by its UUID. Returns `404 not_found` both for unknown IDs *and* for clients belonging to a different organization — the public API never leaks the existence of cross-tenant resources.

GET

/clients/{clientId}

bearerAuth``

AuthorizationBearer <token>

Salfio API tokens start with the literal prefix sk_live_ followed by 32 base62 characters (≈190 bits of entropy). Tokens are hashed at rest with argon2id and shown to the user only once at creation.

In: header

clientId*string

Client UUID.

Formatuuid

application/json

application/json

application/json

application/json

curl -X GET "https://api.salfio.com/v1/clients/497f6eca-6276-4993-bfeb-53cbbbba6f08"

{
  "meta": {
    "cursor": "string",
    "hasMore": true
  },
  "data": {
    "id": "8b2d1c4e-3f5a-4e2b-9c8f-1e2d3c4b5a6f",
    "name": "Acme Corp",
    "domain": "acme.com",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "accountManagers": [
      {
        "userId": "2c4a230c-5085-4924-a3e1-25fb4fc5965b",
        "firstName": "string",
        "lastName": "string",
        "email": "[email protected]"
      }
    ],
    "clientType": "active"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Authentication required"
  }
}

{
  "error": {
    "code": "not_found",
    "message": "client not found"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded",
    "details": {
      "retry_after_seconds": 30
    }
  }
}
Export
Suggest an edit to this page

Documentation menu