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.
v2 · Base URL https://api.fintoc.com/v2Authorizations
Query Parameters
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.
Maximum number of customers to return per page. Defaults to 30, with a maximum of 300.
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 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.
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.
cl_rut, mx_rfc Response
List of customers for the current mode, sorted by creation date (most recent first).
Unique identifier of the customer.
"cus_0ujsswThIGTUYm2K8FjOOfXtY1K"
Type of the object. Always customer.
Customer's address. Only the fields with a value are returned. null when the customer has no address information.
ISO 8601 datetime, in UTC, of when the customer was created.
"2026-01-15T14:30:00Z"
Customer's email, stored in lowercase. null if not provided.
"jared@piedpiper.com"
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 of the customer, matching the mode of the API key used to create it. One of live or test.
live, test "live"
Customer's full name or business name. null if not provided.
"Test Customer 1"
Customer's phone number in E.164 format, including the country code (for example +56911111111). null if not provided.
"+56911111111"
Tax identifier of the customer (Chilean RUT or Mexican RFC). null if not provided.