The Entity object

An Entity represents the legal holder of one or more Account objects. Fintoc returns an Entity object when you list or retrieve your organization’s entities. Your organization has one root Entity, indicated by is_root; an entity progresses from draft to operational before it can transact. The Entity object has the following attributes:

Attribute	Type	Description
`id`	`string`	Unique identifier for this object.
`object`	`string`	Type of the object. Always `entity`.
`country_code`	`string`	ISO 3166-1 alpha-2 country code of the entity, in lowercase, for example `cl` or `mx`. `null` when not set.
`holder_id`	`string`	Mexican tax ID (RFC) of the entity owner, without dots or hyphens. The example uses the placeholder `AAA010101AAA`. Foreign entities use the generic RFC `XEXX010101000`.
`holder_name`	`string`	Legal name of the entity owner.
`is_root`	`boolean`	If `true`, this entity is your organization’s root entity.
`mode`	`string`	API key mode used to create the entity. One of `live` or `test`.
`status`	`string`	Current status of the entity. One of `draft`, `under_review`, `pending_signature`, `canceled`, `waiting_initialization`, `operational`, `rejected`, or `paused`.

Entity object

{
  "id": "ent_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
  "object": "entity",
  "country_code": "mx",
  "holder_id": "AAA010101AAA",
  "holder_name": "Test Entity 1",
  "is_root": true,
  "mode": "test",
  "status": "operational"
}

Fintoc API

Main Resources

Payments API

Transfers API

Movements API

Direct Debit (Legacy)

Fiscal API

The Entity object