Saltar al contenido principal
GET
List customers
v2 · Base URL https://api.fintoc.com/v2

Autorizaciones

Authorization
string
header
requerido

Parámetros de consulta

ending_before
string

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.

limit
integer
predeterminado:30

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

starting_after
string

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_id
string

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
enum<string>

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.

Opciones disponibles:
cl_rut,
mx_rfc

Respuesta

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

id
string
requerido

Unique identifier of the customer.

Ejemplo:

"cus_0ujsswThIGTUYm2K8FjOOfXtY1K"

object
any
requerido

Type of the object. Always customer.

address
object | null
requerido

Customer's address. Only the fields with a value are returned. null when the customer has no address information.

created_at
string<date-time>
requerido

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

Ejemplo:

"2026-01-15T14:30:00Z"

email
string | null
requerido

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

Ejemplo:

"jared@piedpiper.com"

metadata
object
requerido

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

Ejemplo:
mode
enum<string>
requerido

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

Opciones disponibles:
live,
test
Ejemplo:

"live"

name
string | null
requerido

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

Ejemplo:

"Test Customer 1"

phone
string | null
requerido

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

Ejemplo:

"+56911111111"

tax_id
object | null
requerido

Tax identifier of the customer (Chilean RUT or Mexican RFC). null if not provided.