---
title: "List Customers V2"
method: GET
path: "/v2/customers"
tags: ["Customers"]
---

# List Customers V2

`GET /v2/customers`

Retrieve a list of customers filtered by type

## Query parameters

- `type` 'INDIVIDUAL' | 'BUSINESS', required
- `per_page` integer
- `current_page` integer

## Response `200`

List of customers retrieved successfully

- object
  - `data` object
    - `pagination` object
      - `current_page` integer
      - `per_page` integer
      - `total_page` integer
      - `total` integer
    - `customers` union[]
      - union
        - object
          - `customer_id` string, uuid
          - `type` 'INDIVIDUAL'
          - `first_name` string
          - `last_name` string
          - `email` string, email
          - `phone` string
          - `country_of_residence` string
          - `customer_status` string
          - `tos_policies_url` string, uri
          - `created_at` string, date-time
          - `updated_at` string, date-time
        - object
          - `customer_id` string, uuid
          - `type` 'BUSINESS'
          - `business_name` string
          - `email` string, email
          - `phone` string
          - `country_of_incorporation` string
          - `customer_status` string
          - `tos_policies_url` string, uri
          - `created_at` string, date-time
          - `updated_at` string, date-time

## Other responses

- `401` — Authentication failed due to invalid credentials
- `422` — Failed due to a formatting error.

---

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