v1

latestOpenAPI 3.1.02026-07-228956435.8 KB

Customers

List customers

Lists the customers of your organization for the live or test mode of the API key used. Customers are returned sorted by creation date, with the most recently created customers appearing first. Use limit together with the starting_after and ending_before cursors to paginate the results. The Link response header contains the URL of the next page when more results are available.

get/customers

Query parameters

ending_beforestring

Customer id cursor for use in pagination. Returns the page of results immediately before the customer with this id. Cannot be combined with starting_after.

limitinteger

Maximum number of customers to return per page. Defaults to 30, with a maximum of 300.

starting_afterstring

Customer id cursor for use in pagination. Returns the page of results immediately after the customer with this id. Cannot be combined with ending_before.

tax_idstring

Tax identification number to filter by. For cl_rut, use a Chilean tax ID (RUT) with or without dots and hyphens (for example 11.111.111-1 or 111111111). For mx_rfc, use a Mexican tax ID (RFC) in any casing. If you do not provide tax_id_type, Fintoc matches the value against both formats.

tax_id_type'cl_rut' | 'mx_rfc'

Country-specific tax identifier format to filter by. One of cl_rut for Chilean tax ID (RUT) or mx_rfc for Mexican tax ID (RFC). When you send tax_id_type without tax_id, the endpoint returns every customer with a tax ID in that format.

Response

List of customers for the current mode, sorted by creation date (most recent first).

idstring required

Unique identifier of the customer.

object'customer' required

Type of the object. Always customer.

created_atstring date-time required

ISO 8601 datetime, in UTC, of when the customer was created.

emailstring nullable required

Customer's email, stored in lowercase. null if not provided.

metadataobject required

Set of key-value pairs that you can attach to an object. Useful for storing additional information about the object in a structured format.

mode'live' | 'test' required

Mode of the customer, matching the mode of the API key used to create it. One of live or test.

namestring nullable required

Customer's full name or business name. null if not provided.

phonestring nullable required

Customer's phone number in E.164 format, including the country code (for example +56911111111). null if not provided.

Example response

[
  {
    "id": "cus_0ujsswThIGTUYm2K8FjOOfXtY1K",
    "address": {
      "city": "Santiago",
      "country": "cl",
      "line1": "Av. Providencia 123",
      "line2": "Depto 45",
      "postal_code": "7500000",
      "state": "RM"
    },
    "created_at": "2026-01-15T14:30:00Z",
    "email": "jared@piedpiper.com",
    "metadata": {
      "order_id": "12345"
    },
    "mode": "live",
    "name": "Test Customer 1",
    "phone": "+56911111111",
    "tax_id": {
      "type": "cl_rut",
      "value": "111111111"
    }
  }
]