> ## 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

> Campos del objeto `Onboarding` para la revisión Know Your Customer de una `Entity`: `data` por paso, `documents`, representantes, accionistas y `status`.

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`. |
| `legal_representatives` | array | Representantes legales declarados para la `Entity`. Consulta el objeto `OnboardingLegalRepresentative`. |
| `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. |
| `type` | string | Tipo de onboarding. Siempre `account_holder`. |

## Objeto Onboarding Legal Representative

El objeto `OnboardingLegalRepresentative` tiene estos atributos:

| Campo | Tipo | Descripción |
| :- | :- | :- |
| `id` | string | Identificador único del representante legal. |
| `object` | string | Siempre `onboarding_legal_representative`. |
| `documents` | array | Slots de identificación y poder notarial del representante. Consulta el objeto `OnboardingDocument`. |
| `email` | string | Correo electrónico del representante legal. |
| `first_name` | string | Nombre de pila del representante legal. |
| `identification_number` | string | CURP (Clave Única de Registro de Población) del representante legal. |
| `last_name` | string | Apellido del representante legal. |
| `nationality` | string | Código de país ISO 3166-1 alfa-2 de dos letras de la nacionalidad del representante legal. |
| `position` | string | Cargo que ocupa el representante legal en la empresa. |

## 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",
  "legal_representatives": [
    {
      "id": "onblr_0ujsswThIGTUYm2K8FjOOfXtY1K",
      "object": "onboarding_legal_representative",
      "documents": [
        {
          "filename": "ine.pdf",
          "slot_key": "identification",
          "status": "uploaded",
          "uploaded_at": "2026-01-15T14:30:00Z"
        }
      ],
      "email": "rep@example.com",
      "first_name": "Test Customer 1",
      "identification_number": "AAAA010101HDFAAA01",
      "last_name": "Customer",
      "nationality": "mx",
      "position": "Director General"
    }
  ],
  "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,
  "type": "account_holder"
}
```