Customers

Get Customer

GET/v1/customers/{customer_uuid}/

Authorization

X-Api-Key

string required

API key generated in the Developers section of the Stablegate app. Send it in the X-Api-Key header on every request; the partner API does not require request signing.

Path parameters

customer_uuid

string<uuid> required

Customer UUID

Responses

Successful Response

uuid

string<uuid> required

customer_id

string | null

external_reference

string | null

username

string required

full_name

string | null

phone

string | null

type

string | null

One of: individual, corporate

state

string required

One of: new, active, blocked, limited, closed

country_code

string | null

email_verified

boolean required

created_at

string<date-time> required

kyc_level

object | null

is_funded

boolean required

permissions

object required

Permissions flags resolved for the customer.

Validation Error

trace_id

string required

error_code

string required

One of: devapi_internal_error, devapi_request_validation_error, devapi_iban_parse_error, devapi_customer_close_error, devapi_bank_code_required_error, devapi_download_aol_error, devapi_not_found_error, devapi_bad_request_error, devapi_email_occupied_error, devapi_idempotency_invalid_key, devapi_idempotency_key_misuse, devapi_idempotency_request_in_progress, devapi_kyc_application_link_error, devapi_instant_verification_error, devapi_unauthorized_error, devapi_forbidden_error, devapi_method_not_allowed_error, devapi_service_unavailable_error

message

string required

details

object[] required

curl https://api.stablegate.com/v1/customers/CUSTOMER_UUID/ \
  --header 'X-Api-Key: YOUR_API_KEY'

{
  "uuid": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "customer_id": "string",
  "external_reference": "string",
  "username": "string",
  "full_name": "string",
  "email": "string",
  "phone": "string",
  "type": "individual",
  "state": "new",
  "country_code": "string",
  "email_verified": true,
  "created_at": "2026-01-01T00:00:00Z",
  "kyc_level": {
    "uuid": "string",
    "legal_entity_uuid": "string",
    "key": "string",
    "client_type": "individual",
    "name": "string",
    "title": "string",
    "icon": "string",
    "approval_date": "2026-01-01T00:00:00Z",
    "approved_by": {
      "uuid": "string",
      "first_name": "string",
      "last_name": "string"
    }
  },
  "is_funded": true,
  "permissions": {
    "can_trade": true,
    "can_download_aol": true
  }
}

{
  "trace_id": "string",
  "error_code": "devapi_internal_error",
  "message": "string",
  "details": [
    {
      "loc": "string",
      "msg": "string",
      "type": "string"
    }
  ]
}

Create Customer

Download Account Opening Letter