> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Objeto Onboarding

> >-

Un `Onboarding` contiene la revisión Know Your Customer de una `Entity`: información de la empresa, representante legal, perfil transaccional, accionistas y documentos. Creas un onboarding por cada `Entity`, completas cada paso y documento, y envías el onboarding para que Fintoc lo revise.

El objeto `Onboarding` tiene estos atributos:

| Campo          | Tipo    | Descripción                                                                                                               |
| :------------- | :------ | :------------------------------------------------------------------------------------------------------------------------ |
| `id`           | string  | Identificador único del onboarding.                                                                                       |
| `object`       | string  | El tipo del objeto, que siempre es `onboarding`.                                                                          |
| `data`         | object  | Datos revisados de cada paso completado, indexados por la clave del paso.                                                 |
| `documents`    | array   | Espacios de documentos a lo largo de cada paso, con su estado de carga. Consulta el objeto `OnboardingDocument`.          |
| `entity_id`    | string  | Identificador de la `Entity` a la que pertenece este onboarding. `null` si el onboarding no está asociado a una `Entity`. |
| `reviewed_at`  | string  | Fecha y hora en UTC (ISO 8601) en que Fintoc revisó el onboarding. `null` hasta que Fintoc revise el onboarding.          |
| `shareholders` | array   | Accionistas declarados para la `Entity`. Consulta el objeto `OnboardingShareholder`.                                      |
| `source`       | string  | Canal por el que se completó el onboarding. Uno de `api` o `dashboard`.                                                   |
| `status`       | string  | Estado actual del onboarding. Uno de `pending`, `in_progress`, `submitted`, `approved`, `rejected` o `cancelled`.         |
| `submittable`  | boolean | Indica si el onboarding tiene todos los pasos y documentos requeridos completados.                                        |
| `submitted_at` | string  | Fecha y hora en UTC (ISO 8601) en que enviaste el onboarding para revisión. `null` hasta que envíes el onboarding.        |

## Objeto Onboarding Shareholder

El objeto `OnboardingShareholder` tiene estos atributos:

| Campo        | Tipo   | Descripción                                                                                      |
| :----------- | :----- | :----------------------------------------------------------------------------------------------- |
| `id`         | string | Identificador único del accionista.                                                              |
| `object`     | string | El tipo del objeto, que siempre es `onboarding_shareholder`.                                     |
| `document`   | object | Espacio del documento de identificación del accionista. Consulta el objeto `OnboardingDocument`. |
| `holder_id`  | string | RFC mexicano del accionista. `null` si no se proporcionó.                                        |
| `last_name`  | string | Apellido. Solo está presente cuando `type` es `natural_person`.                                  |
| `name`       | string | Nombre de pila de una persona física, o razón social de una persona moral.                       |
| `parent_id`  | string | Identificador del accionista padre cuando está anidado. `null` para accionistas raíz.            |
| `percentage` | number | Porcentaje de participación del accionista, de `0` a `100`.                                      |
| `type`       | string | Tipo de accionista. Uno de `natural_person` o `legal_entity`.                                    |

## Objeto Onboarding Document

El objeto `OnboardingDocument` tiene estos atributos:

| Campo         | Tipo   | Descripción                                                                                                    |
| :------------ | :----- | :------------------------------------------------------------------------------------------------------------- |
| `filename`    | string | Nombre original del documento cargado. Solo está presente cuando `status` es `uploaded`.                       |
| `slot_key`    | string | Clave que identifica el espacio del documento.                                                                 |
| `status`      | string | Estado del espacio del documento. Uno de `uploaded` o `missing`.                                               |
| `uploaded_at` | string | Fecha y hora en UTC (ISO 8601) en que cargaste el documento. Solo está presente cuando `status` es `uploaded`. |

```json Onboarding object theme={null}
{
  "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
}
```