---
title: "Get Customer Onboarding Status for a specific currency"
method: GET
path: "/v1/customers/{customer_id}/onboarding/{currency}"
tags: ["Customers"]
---

# Get Customer Onboarding Status for a specific currency

`GET /v1/customers/{customer_id}/onboarding/{currency}`

Get Customer Onboarding Status for a specific currency

## Path parameters

- `customer_id` string, uuid, required
- `currency` 'usd' | 'eur' | 'gbp' | 'aed', required

## Response `200`

Successfully retrieved customer onboarding status

- Onboarding
  - `currency` 'AED' | 'USD' | 'JOD' | 'EGP' | 'SAR' | 'GBP' | 'EUR' | 'HKD' | 'CNH' | 'SGD', required
  - `customer_id` string, uuid, required
  - `status` union, required
    - 'pending'
    - 'completed'
    - object
      - `failed` OnboardingError, required
        - `code` 'missing_document' | 'missing_currency_data' | 'no_shareholders' | 'insufficient_majority_owership' | 'shareholder_not_onboarded' | 'business_registration_date_missing' | 'invalid_business_registration_date' | 'business_registration_number_missing' | 'business_trade_license_expiry_missing' | 'expired_trade_license' | 'expired_identification_document' | 'individual_missing_proof_of_address_document' | 'business_missing_proof_of_address_document' | 'invalid_documents' | 'invalid_customer_name' | 'invalid_shareholder_name' | 'invalid_customer_address', required
        - `msg` string, required

---

[API](https://skmtc.net/lorum/apis/auth-api.md) · [All operations](https://skmtc.net/lorum/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lorum/auth-api/versions/f9b8935027e3/schema)