Onboarding holds the Know Your Customer review of an Entity: company information, legal representative, transactional profile, shareholders, and documents. You create one onboarding per Entity, complete each step and document, and submit the onboarding for Fintoc to review.
The Onboarding object has these attributes:
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier of the onboarding. |
object | string | The type of the object, which is always onboarding. |
data | object | Reviewed data for each completed step, keyed by step key. |
documents | array | Document slots across every step, with their upload status. See the OnboardingDocument object. |
entity_id | string | Identifier of the Entity this onboarding belongs to. null if the onboarding is not associated with an Entity. |
reviewed_at | string | ISO 8601 datetime in UTC when Fintoc reviewed the onboarding. null until Fintoc reviews the onboarding. |
shareholders | array | Shareholders declared for the Entity. See the OnboardingShareholder object. |
source | string | Completion channel for the onboarding. One of api or dashboard. |
status | string | Current status of the onboarding. One of pending, in_progress, submitted, approved, rejected, or cancelled. |
submittable | boolean | Whether the onboarding has every required step and document completed. |
submitted_at | string | ISO 8601 datetime in UTC when you submitted the onboarding for review. null until you submit the onboarding. |
Onboarding Shareholder object
TheOnboardingShareholder object has these attributes:
| Field | Type | Description |
|---|---|---|
id | string | Unique identifier of the shareholder. |
object | string | The type of the object, which is always onboarding_shareholder. |
document | object | Identification document slot for the shareholder. See the OnboardingDocument object. |
holder_id | string | Mexican tax ID (RFC) of the shareholder. null if not provided. |
last_name | string | Last name. Only present when type is natural_person. |
name | string | Given name of a natural person, or business name of a legal entity. |
parent_id | string | Identifier of the parent shareholder when nested. null for root shareholders. |
percentage | number | Participation percentage held by the shareholder, from 0 to 100. |
type | string | Type of shareholder. One of natural_person or legal_entity. |
Onboarding Document object
TheOnboardingDocument object has these attributes:
| Field | Type | Description |
|---|---|---|
filename | string | Original filename of the uploaded document. Only present when status is uploaded. |
slot_key | string | Key identifying the document slot. |
status | string | Document slot status. One of uploaded or missing. |
uploaded_at | string | ISO 8601 datetime in UTC when you uploaded the document. Only present when status is uploaded. |
Onboarding object
{
"id": "onbprc_0ujsswThIGTUYm2K8FjOOfXtY1K",
"object": "onboarding",
"data": {
"company_information": {
"legal_name": "Test Company 1"
}
},
"documents": [
{
"filename": "csf.pdf",
"slot_key": "tax_registration_certificate",
"status": "uploaded",
"uploaded_at": "2026-01-15T14:30:00Z"
}
],
"entity_id": "ent_8anBwgZktbZH6ydyHa6Tm0eM",
"reviewed_at": null,
"shareholders": [
{
"id": "onbsh_0ujsswThIGTUYm2K8FjOOfXtY1K",
"object": "onboarding_shareholder",
"document": {
"filename": "ine.pdf",
"slot_key": "identification",
"status": "uploaded",
"uploaded_at": "2026-01-15T14:30:00Z"
},
"holder_id": "AAAA010101AAA",
"last_name": "Customer",
"name": "Test Customer 1",
"parent_id": null,
"percentage": 76,
"type": "natural_person"
}
],
"source": "api",
"status": "in_progress",
"submittable": false,
"submitted_at": null
}