---
title: "Get customer"
method: GET
path: "/v1/customers/{customer_id}"
tags: ["Customers"]
---

# Get customer

`GET /v1/customers/{customer_id}`

Get customer

## Path parameters

- `customer_id` string, Uuid, required

## Response `200`

Successfully retrieved contents of directory

- union
  - object
    - `individual` object, required
      - `currency_extra` IndividualCurrencyExtra[], required
        - `country_of_birth` string, string, required — Country of birth. it should be ISO3166-1 Alpha2 country code
        - `country_of_issuance` string, string, required — Country where id was issues. it should be ISO3166-1 Alpha2 country code
        - `currency` 'usd', required
        - `id_number` string, string, required — Valid person id number (Passport or national id).
        - `ip_address` string, string — Optional IP address to use as a Proof of Address. Can be in IPv4 or IPv6 format.
        - `occupation_code` string, string, required — US occupation code as defined by the Standard Occupational Classification (SOC) system. See https://reference.fuse.me/soc.html for supported list of codes.
      - `date_of_birth` string, date-time, required
      - `first_name` string, required
      - `gender` 'male' | 'female' | 'undefined', required
      - `identification` union — Individual Identification Identification document of an individual.
        - object
          - `country_of_issuance` string, string, required — Country of issuance (i.e: US, AE)
          - `expiry_date` string, date, required — Expiry date of the passport.
          - `number` string, string, required — Passport number.
          - `type` 'passport', required
        - object
          - `country_of_issuance` string, string, required — Country of issuance. (i.e: US, AE)
          - `expiry_date` string, date, required — Expiry date of the ID.
          - `number` string, string, required — National ID number.
          - `type` 'national_id', required
      - `last_name` string, required
      - `middle_name` string, nullable
      - `nationality` string, string, required
    - `address` Address, required
      - `country_code` string, string, required
      - `line_1` string, string, required
      - `line_2` string, string, nullable — ***optional*** for `AED` payments but ***mandatory*** for `USD` payments
      - `line_3` string, string, nullable
      - `line_4` string, string, nullable
    - `approval_status` 'auto_approved' | 'pending' | 'approved' | 'rejected', required
    - `display_name` string, required
    - `documents` DocumentSummary[], required
      - `document_type` 'passport' | 'visa' | 'national_id' | 'trade_licence' | 'commercial_licence' | 'identity_verification_biometrics' | 'incorporation_cert' | 'incumbency_cert' | 'memorandum_articles' | 'bank_statement' | 'photo' | 'proof_of_address' | 'regulatory_license' | 'articles_of_association' | 'source_of_funds' | 'aml_cft_sanctions_ind_audit' | 'aml_cft_sanctions_policy' | 'compliance_officer_resume' | 'financial_statements' | 'share_certificate' | 'corporate_resolution' | 'wolfsberg_gcbddq' | 'edd_concentration_form' | 'other', required — Types of documents that can be uploaded for customers and transactions.
      - `id` string, uuid, required
      - `reference` string, string, required
    - `id` string, uuid, required
    - `reference` string, required
    - `rejection_reason` 'prohibited' | 'sanction' | 'pep' | 'financial_crimes' | 'other'
    - `relationship_type` union, required — Represents the relationship between a customer and the organisation.
      - 'direct' — The customer is a direct customer of the organisation. The customer is contracted with the organisation.
      - object — The customer is a sub-customer of the organisation. The customer is contracted with a direct customer of the organisation.
        - `indirect` object, required — The customer is a sub-customer of the organisation. The customer is contracted with a direct customer of the organisation.
          - `parent_customer_id` string, uuid, required
  - object
    - `business` object, required
      - `business_name` string, required
      - `country_of_issuance` string, string, required
      - `currency_extra` BusinessCurrencyExtra[], required
        - union — Represents the currency specific data for a business.
          - object
            - `currency` 'usd', required
            - `industry_code` string, string, required — US industry code as defined by the North American Industry Classification System (NAICS) system. See https://reference.fuse.me/naics.html for supported list of codes.
            - `ip_address` string, string — Optional IP address to use as a Proof of Address. Can be in IPv4 or IPv6 format.
            - `tax_number` string, string, required — Valid business tax number.
          - object
            - `currency` 'aed', required
            - `license_issuer` 'mainland' | 'freezone' | 'international', required
            - `trade_license_expiry` string, date, nullable
      - `issuance_authority` string, nullable
      - `registration_date` string, date, nullable
      - `registration_number` string, required
      - `regulatory_licenses` RegulatoryLicenseType[], required
    - `address` Address, required
      - `country_code` string, string, required
      - `line_1` string, string, required
      - `line_2` string, string, nullable — ***optional*** for `AED` payments but ***mandatory*** for `USD` payments
      - `line_3` string, string, nullable
      - `line_4` string, string, nullable
    - `approval_status` 'auto_approved' | 'pending' | 'approved' | 'rejected', required
    - `display_name` string, required
    - `documents` DocumentSummary[], required
      - `document_type` 'passport' | 'visa' | 'national_id' | 'trade_licence' | 'commercial_licence' | 'identity_verification_biometrics' | 'incorporation_cert' | 'incumbency_cert' | 'memorandum_articles' | 'bank_statement' | 'photo' | 'proof_of_address' | 'regulatory_license' | 'articles_of_association' | 'source_of_funds' | 'aml_cft_sanctions_ind_audit' | 'aml_cft_sanctions_policy' | 'compliance_officer_resume' | 'financial_statements' | 'share_certificate' | 'corporate_resolution' | 'wolfsberg_gcbddq' | 'edd_concentration_form' | 'other', required — Types of documents that can be uploaded for customers and transactions.
      - `id` string, uuid, required
      - `reference` string, string, required
    - `id` string, uuid, required
    - `reference` string, required
    - `rejection_reason` 'prohibited' | 'sanction' | 'pep' | 'financial_crimes' | 'other'
    - `relationship_type` union, required — Represents the relationship between a customer and the organisation.
      - 'direct' — The customer is a direct customer of the organisation. The customer is contracted with the organisation.
      - object — The customer is a sub-customer of the organisation. The customer is contracted with a direct customer of the organisation.
        - `indirect` object, required — The customer is a sub-customer of the organisation. The customer is contracted with a direct customer of the organisation.
          - `parent_customer_id` string, uuid, 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)