Skip to main content
GET
Get an entity

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

Unique identifier of the entity.

Response

The requested entity.

id
string
required

Unique identifier of the entity.

Example:

"ent_2daFu0zqqDtZGJaSi2TGI2Mm1nN"

object
any
required

Type of the object. Always entity.

capabilities
object
required

Statuses for the entity's capabilities. A capability is a role the entity can take in Fintoc, such as holding accounts or receiving settlements. Each capability has its own onboarding, so the statuses can differ.

country_code
string | null
required

ISO 3166-1 alpha-2 country code of the entity, in lowercase, or null when not set. For example, cl or mx.

Example:

"mx"

holder_id
string
required

Mexican tax ID (RFC) of the entity owner, without dots or hyphens. For a foreign entity, the value is the generic foreign RFC XEXX010101000.

Example:

"AAA010101AAA"

holder_name
string
required

Legal name of the entity owner.

Example:

"Test Entity 1"

is_root
boolean
required

Whether this entity is your organization's root entity.

Example:

true

mode
enum<string>
required

Whether the entity belongs to live or test data. One of live or test.

Available options:
live,
test
Example:

"test"

status
enum<string>
required

Overall status of the entity. The value is operational when any capability is operational. Otherwise, the value matches the account_holder capability status. Use capabilities to check each capability on its own. One of draft, under_review, pending_signature, canceled, waiting_initialization, operational, rejected, or paused.

Available options:
draft,
under_review,
pending_signature,
canceled,
waiting_initialization,
operational,
rejected,
paused
Example:

"operational"