---
title: "List Customers"
method: GET
path: "/v2/customer"
tags: ["Customer"]
---

# List Customers

`GET /v2/customer`

## Query parameters

- `search` string, required
- `order_criteria` string
- `order_by` 'ASC' | 'DESC'
- `page_number` integer
- `page_size` integer

## Response `200`

Successful

- CustomerResponse[]
  - `id` string, uuid, required — Customer UUID.
  - `billing` Billing
    - `address_1` string — Customer's primary billing address information. **Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements.
    - `address_2` string — Customer's secondary billing address information.
    - `address_3` string — Customer's third billing address information.
    - `city` string — Customer's city on their billing address. **Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements.
    - `country_code` string — Customer's alpha-2 ISO 3166 country code (e.g. `US` for United States). **Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements.
    - `first_name` string — Customer's first name. **Required** when `company_name` is not provided. **Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements.
    - `middle_name` string — Customer's middle name.
    - `last_name` string — Customer's last name. **Required** when `company_name` is not provided. **Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements.
    - `phone` string — Customer's phone number for the billing address.
    - `postal_code` string — Customer's postal code for their billing address. **Note:** Required for 3DS unless a market or regional mandate restricts sending this information.
    - `state` string — Customer's state or province for their billing address (e.g. `OH` for Ohio, `TX` for Texas).
  - `company_name` string — Company name of the customer. **Required** when `billing.first_name` and `billing.last_name` are not provided.
  - `company_registration_number` string — Unique identifier of the company recognised by the government. Known as CoC (Chamber of Commerce) number in some countries.
  - `email_address` string, email — Consumer's email address. **Note:** Required for 3DS. Please refer to the 3D Secure API specification for format requirements.
  - `entity_id` string, required — Entity ID on which the customer is created.
  - `phone_number` string — Cardholder's phone number.
  - `shipping` Shipping
    - `address_1` string — Consumer's primary shipping address information. **Field required for:** Klarna, PayPal, Vipps, MobilePay, Google Pay, Apple Pay, Affirm, Swish
    - `address_2` string — Consumer's secondary shipping address information. **Field required for:** PayPal
    - `address_3` string — Consumer's third shipping address information.
    - `city` string — Consumer's city on their shipping address. **Field required for:** Klarna, PayPal, Vipps, MobilePay, Google Pay, Apple Pay, Affirm, Swish
    - `first_name` string — Consumer's first name. **Field required for:** Klarna, Vipps, MobilePay
    - `middle_name` string — Consumer's middle name.
    - `last_name` string — Consumer's last name. **Field required for:** Klarna, Vipps, MobilePay
    - `phone` string — Consumer's phone number for the shipping address. **Field required for:** Klarna, PayPal, Vipps, MobilePay
    - `country_code` string — Consumer's alpha-2 ISO 3166 country code (e.g. `US` for United States). **Field required for:** Klarna, PayPal, Vipps, MobilePay, Google Pay, Apple Pay, Affirm, Swish
    - `postal_code` string — Consumer's postal code for their shipping address. **Field required for:** Klarna, PayPal, Vipps, MobilePay, Google Pay, Apple Pay, Affirm, Swish
    - `state` string — Consumer's state or province for their shipping address (e.g. `OH` for Ohio, `TX` for Texas). **Field required for:** Klarna, PayPal
  - `title` string — Customer's title (e.g. `Mr`, `Mrs`, `Dr`).
  - `work_phone` string — Consumer's work phone number.
  - `tax` Tax
    - `identifier` string — An optional identifier of the document recipient: - Personal ID (for individuals) - Tax identification number (for businesses)
  - `language` string — Customer language preference for Invoice documents. See [Localisation](https://docs.verifone.com/online-payments/checkout/localization) for details.
  - `created_at` string, date-time, required — Timestamp when this customer was created.
  - `updated_at` string, date-time, required — Timestamp when this customer was last updated.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/verifone/apis/checkout-api.md) · [All operations](https://skmtc.net/verifone/apis/checkout-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/verifone/checkout-api/revisions/ed8dc1f12a5a/schema)