Skip to main content
GET
Get a customer
v2 · Base URL https://api.fintoc.com/v2

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

The unique identifier of the customer (for example cus_0ujsswThIGTUYm2K8FjOOfXtY1K).

Response

The customer with the given id.

id
string
required

Unique identifier of the customer.

Example:

"cus_0ujsswThIGTUYm2K8FjOOfXtY1K"

object
any
required

Type of the object. Always customer.

address
object | null
required

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

created_at
string<date-time>
required

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

Example:

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

email
string | null
required

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

Example:

"jared@piedpiper.com"

metadata
object
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.

Example:
mode
enum<string>
required

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

Available options:
live,
test
Example:

"live"

name
string | null
required

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

Example:

"Test Customer 1"

phone
string | null
required

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

Example:

"+56911111111"

tax_id
object | null
required

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