---
title: "Get All Customers"
method: GET
path: "/customer"
tags: ["Customer"]
---

# Get All Customers

`GET /customer`

## Request

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

Retrieve a list of all customers. You can filter the list with query parameters. 

This API comes with Pagination support, you can customize ```limit``` and ```page``` query parameters as per the requirements.

## Query parameters

- `type` string
- `created_at` string
- `include_deleted` boolean
- `start_time` integer
- `end_time` integer
- `limit` integer
- `page` integer

## 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

## Changes

- **2026-11-03** `39e5e5ab5c3a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/finmo/apis/finmo-api/changes/customer/get.md)

---

[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)