# Get list of customers

Get list of customers

Endpoint: GET /customers
Version: 2.2.0
Security: bearerAuth, basicAuth

## Query parameters:

  - `page` (number, required)
    Specifies page number
    Example: 2

  - `createdFrom` (string)
    The createdAt date from witch the customers will be fetched
    Example: "2025-05-12"

  - `createdTo` (string)
    The createdAt date to witch the customers will be fetched
    Example: "2025-05-15"

  - `merchantCustomerId` (string)
    The merchant customer id
    Example: "Test_Merchant"

  - `email` (string)
    The email address
    Example: "test@gmail.com"

  - `phoneCountry` (string)
    The phone country code
    Example: "33"

  - `phoneNumber` (string)
    The phone number
    Example: "98746321"

## Response 200 fields (application/json):

  - `totalNumberOfPages` (number)
    Indicates total number of pages that exist.

  - `totalNumberOfItems` (number)
    Indicates total number of items that exist.

  - `page` (number)
    Indicates number of page that is retrieved.

  - `pageSize` (number)
    Indicates max number of items on page.

  - `data` (array)

  - `data.id` (string)
    Unique identifier of the customer assigned by Axepta Online.

  - `data.merchantCustomerId` (string)
    Unique identifier of the customer assigned by merchant.

  - `data.firstName` (string)
    First name of the customer. Present if passed by merchant in Payment.

  - `data.lastName` (string)
    Last name of the customer. Present if passed by merchant in Payment.

  - `data.companyName` (string)
    Last name of the customer. Present if passed by merchant in Payment.

  - `data.email` (string)
    E-mail address of the customer. Present if passed by merchant in Payment.

  - `data.phone` (object)

  - `data.phone.countryCode` (string)
    Area or country code of the phone number of the customer. Present if passed by merchant in Payment.

  - `data.phone.number` (string)
    Phone number of the customer. Present if passed by merchant in Payment.

  - `data.scope` (string)
    Scope of customer vault. Present if configured for the merchant in MAT.

  - `data.createdAt` (string)
    Creation date and time in ISO 8601 format.

  - `data.updatedAt` (string)
    Update date and time in ISO 8601 format.


## Response 500 fields