---
title: "Get Customer"
canonical_url: "https://docs.stablegate.com/docs/apiref/customers/get-customer"
---
# Get Customer

::api-operation{color="success" endpoint="/v1/customers/{customer_uuid}/" method="GET"}
## Authorization

::field-group
::field{name="X-Api-Key" type="string" :required="true"}
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

::field-group
:field[Customer UUID]{name="customer_uuid" type="string<uuid>" :required="true"}
::

## Responses

::tabs
::tabs-item{label="200"}
Successful Response

::field-group
:field{name="uuid" type="string<uuid>" :required="true"}:field{name="customer_id" type="string | null"}:field{name="external_reference" type="string | null"}:field{name="username" type="string" :required="true"}:field{name="full_name" type="string | null"}:field{name="email" type="string | null"}:field{name="phone" type="string | null"}::field{name="type" type="string | null"}
One of: `individual`, `corporate`
::

::field{name="state" type="string" :required="true"}
One of: `new`, `active`, `blocked`, `limited`, `closed`
::

:field{name="country_code" type="string | null"}:field{name="email_verified" type="boolean" :required="true"}:field{name="created_at" type="string<date-time>" :required="true"}::field{name="kyc_level" type="object | null"}
::collapsible{name="properties"}
::field-group
:field{name="uuid" type="string<uuid4>" :required="true"}:field{name="legal_entity_uuid" type="string<uuid4>" :required="true"}:field{name="key" type="string" :required="true"}::field{name="client_type" type="string" :required="true"}
One of: `individual`, `corporate`, `all`
::

:field{name="name" type="string | null"}:field{name="title" type="string | null"}:field{name="icon" type="string | null"}:field{name="approval_date" type="string<date-time> | null"}::field{name="approved_by" type="object | null"}
::collapsible{name="properties"}
::field-group
:field{name="uuid" type="string<uuid4>" :required="true"}:field{name="first_name" type="string | null"}:field{name="last_name" type="string | null"}
::
::
::
::
::
::

:field{name="is_funded" type="boolean" :required="true"}::field{name="permissions" type="object" :required="true"}
Permissions flags resolved for the customer.

::collapsible{name="properties"}
::field-group
:field{name="can_trade" type="boolean" :required="true"}:field{name="can_download_aol" type="boolean" :required="true"}
::
::
::
::
::

::tabs-item{label="422"}
Validation Error

::field-group
:field{name="trace_id" type="string" :required="true"}::field{name="error_code" type="string" :required="true"}
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`
::

:field{name="message" type="string" :required="true"}::field{name="details" type="object[]" :required="true"}
::collapsible{name="properties"}
::field-group
:field{name="loc" type="string | string[]" :required="true"}:field{name="msg" type="string" :required="true"}:field{name="type" type="string" :required="true"}
::
::
::
::
::
::

::template{v-slot:samples=""}
::code-switcher{method="GET" path="/v1/customers/CUSTOMER_UUID/"}
```bash
curl https://api.stablegate.com/v1/customers/CUSTOMER_UUID/ \
  --header 'X-Api-Key: YOUR_API_KEY'
```
::

::code-group
```json [200]
{
  "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
  }
}
```

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


## Sitemap

See the full [sitemap](https://docs.stablegate.com/sitemap.md) for all pages.