# Retrieves a list of customers

Retrieve a list of customers that have been created for your account. The customers are sorted, with the most recent first.

Endpoint: GET /customers
Version: v1
Security: apiKey

## Response 200 fields (application/json):

  - `type` (string, required)
    Enum: "list"

  - `data` (array, required)
    Example: [{"id":"CU7JRN6W6K3DA9","type":"customer","email":"customer@paypro.nl","first_name":"firstname","last_name":"name","address":"address 2","postal":"1234AA","city":"city","country":"NL","vat_number":"vatnumber","company_name":"PayPro","phone_number":"012345679","created_at":"2022-12-31T23:00:00Z","_links":{"self":"https://api.paypro.nl/customers/CU7JRN6W6K3DA9"}}]

  - `data.id` (string, required)
    Example: "CU7JRN6W6K3DA9"

  - `data.type` (string, required)
    Enum: "customer"

  - `data.email` (string,null, required)
    Example: "customer@paypro.nl"

  - `data.first_name` (string,null, required)
    Example: "firstname"

  - `data.last_name` (string,null, required)
    Example: "name"

  - `data.address` (string,null, required)
    Example: "address 2"

  - `data.postal` (string,null, required)
    Example: "1234AA"

  - `data.city` (string,null, required)
    Example: "city"

  - `data.country` (string,null, required)
    Example: "NL"

  - `data.vat_number` (string,null, required)
    Example: "vatnumber"

  - `data.company_name` (string,null, required)
    Example: "PayPro"

  - `data.phone_number` (string,null, required)
    Example: "012345679"

  - `data.created_at` (string, required)
    Example: "2022-12-31T23:00:00Z"

  - `data._links` (object, required)
    Example: {"self":"https://api.paypro.nl/customers/CU7JRN6W6K3DA9"}

  - `data._links.self` (string, required)
    Example: "https://api.paypro.nl/customers/CU7JRN6W6K3DA9"

  - `count` (integer, required)

  - `_links` (object, required)

  - `_links.self` (string, required)

  - `_links.next` (string)

  - `_links.prev` (string)