---
title: "Get Customer by ID"
method: GET
path: "/customer/{customer}"
tags: ["Customer"]
---

# Get Customer by ID

`GET /customer/{customer}`

## Request

- Base URL: `https://api.finmo.net/v1`
- URL: `https://api.finmo.net/v1/customer/{customer}`
- Auth: HTTP basic

Retrieve the details of a customer by using their customer reference ID (```customer_*```).

## Path parameters

- `customer` string, required

## Query parameters

- `include_deleted` boolean

## Response `200`

OK

- object
  - `data` object
    - `company` object
      - `address_city` string
      - `address_country` string
      - `address_line1` string
      - `address_line2` string
      - `address_state` string
      - `address_zip_code` string
      - `incorporation_date` string, date-time
      - `incorporation_certificate_document_id` string
      - `address_proof_document_id` string
      - `authorized_user` object
        - `address_city` string
        - `address_country` string
        - `address_line1` string
        - `address_line2` string
        - `address_state` string
        - `address_zip_code` string
        - `country_of_residence` string
        - `dob` string
        - `email` string
        - `first_name` string
        - `identification_custom_type` string, nullable
        - `identification_type` string
        - `identification_value` string
        - `last_name` string
        - `nationality` string
        - `phone_country_code` string
        - `phone_number` string
        - `phone_number_e164` string
        - `address_proof_document_id` string
        - `identification_document_id` string
      - `email` string
      - `incorporation_country` string
      - `name` string
      - `phone_country_code` string
      - `phone_number` string
      - `phone_number_e164` string
      - `registration_number` string
    - `created_at` string, date-time
    - `created_by` string
    - `customer_id` string
    - `description` string
    - `gca_activated_at` string, date-time
    - `gca_activation_status` string
    - `is_enabled` boolean
    - `account_usage_purpose` string
    - `status` string
    - `is_active` boolean
    - `is_gca_enabled` string
    - `is_wallet_ready` boolean
    - `is_deleted` boolean
    - `metadata` object
      - `any-custom-ref` string
    - `org_id` string
    - `organization_reference_id` string
    - `type` string
    - `updated_at` string, date-time
    - `webhook_url` string, uri
  - `request_id` string
  - `request_time` string, date-time
  - `status_code` integer
  - `status_text` string
  - `success` boolean

## Other responses

- `404`: Not Found

---

[API](https://skmtc.dev/finmo/apis/finmo-api.md) - [All operations](https://skmtc.dev/finmo/apis/finmo-api/llms.txt) - [OpenAPI document](https://skmtc.dev/finmo/apis/finmo-api/revisions/39e5e5ab5c3a?raw)