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

# Crear una entidad

Registra una persona física (INDIVIDUAL) o una persona jurídica (COMPANY) con su documento de identificación. La entidad se crea con estado PENDING\_KYC y sin archivos; sube los archivos de respaldo posteriormente con «Subir una prueba».

* Los datos mínimos de KYC se validan en la creación: name y lastname para INDIVIDUAL, name para COMPANY. De lo contrario, la API devuelve 422 INCOMPLETE\_KYC\_DATA.
* Las propiedades desconocidas se rechazan con 400 VALIDATION\_ERROR. Incluye cualquier dato adicional en attributes.
* Los códigos de país deben ser ISO 3166-1 alpha-3 (BRA, no BR).
* Un identificador fiscal (CPF, CNPJ, CUIT, RFC, …) es un documento, no un campo de la entidad. Envíalo en document; documents\[] no se acepta en la creación (400 VALIDATION\_ERROR).
* Agrega los demás documentos (documento de identidad, comprobante de domicilio, acta constitutiva) con «Agregar un documento».
* Conserve document.documentId de la respuesta: es el docId que se usa para subir archivos al documento principal.

Los errores usan `application/problem+json` con un `code` estable. Catálogo completo: [Estados de entidad y códigos de error](https://docs.localpayment.com/es/reference/entity-statuses-and-error-codes.md).


## OpenAPI

````yaml openapi/es/localpayment.json POST /api/entity/v1/entities
openapi: 3.1.0
info:
  version: '1.0'
  title: Localpayment
  contact:
    name: Support
    url: mailto:support@localpayment.com
servers:
  - url: https://api.stage.localpayment.com
    description: Stage
security:
  - token: []
paths:
  /api/entity/v1/entities:
    post:
      summary: Crear una entidad
      operationId: create-entity
      parameters:
        - name: Authorization
          in: header
          description: >-
            Token de acceso Bearer para la autenticación. Este token se obtiene
            de los endpoints [Get Access Token](/es/reference/get-token) o
            [Refresh Access Token](/es/reference/refresh-token). Tu cuenta de
            comerciante y el usuario que actúa se determinan a partir de él.
          required: true
          schema:
            type: string
            examples:
              - Bearer <your_access_token>
        - name: X-Correlation-ID
          in: header
          description: >-
            Identificador de seguimiento (UUID). Se incluye en la respuesta;
            Localpayment lo genera si no está presente.
          required: false
          schema:
            type: string
            examples:
              - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                externalId:
                  type: string
                  description: >-
                    Tu propio identificador para la entidad. Único por
                    comerciante, de 1 a 64 caracteres.
                  examples:
                    - f47ac10b-58cc-4372-a567-0e02b2c3d479
                type:
                  type: string
                  description: INDIVIDUAL (persona física) o COMPANY (entidad jurídica).
                  enum:
                    - INDIVIDUAL
                    - COMPANY
                  examples:
                    - COMPANY
                name:
                  type: string
                  description: >-
                    Nombre (INDIVIDUAL) o razón social (COMPANY). Hasta 255
                    caracteres.
                  examples:
                    - Example Company S.A.
                lastname:
                  type: string
                  description: Apellido. Obligatorio para INDIVIDUAL. Hasta 255 caracteres.
                  examples:
                    - Doe
                birthdate:
                  type: string
                  format: date
                  description: AAAA-MM-DD. Recomendado para INDIVIDUAL.
                  examples:
                    - '1990-01-15'
                gender:
                  type: string
                  description: MALE, FEMALE, OTHER o UNDISCLOSED.
                  enum:
                    - MALE
                    - FEMALE
                    - OTHER
                    - UNDISCLOSED
                  examples:
                    - FEMALE
                nationality:
                  type: string
                  description: ISO 3166-1 alfa-3 (BRA, ARG, MEX).
                  examples:
                    - BRA
                birthCountry:
                  type: string
                  description: ISO 3166-1 alfa-3.
                  examples:
                    - BRA
                residenceCountry:
                  type: string
                  description: >-
                    ISO 3166-1 alfa-3. Para una COMPANY, país de residencia
                    fiscal.
                  examples:
                    - BRA
                occupation:
                  type: string
                  description: Ocupación de la persona. Hasta 100 caracteres.
                  examples:
                    - Engineer
                isPep:
                  type: boolean
                  description: 'Persona políticamente expuesta. Valor predeterminado: falso.'
                  examples:
                    - false
                incorporationDate:
                  type: string
                  format: date
                  description: AAAA-MM-DD. Solo COMPANY.
                  examples:
                    - '2020-01-15'
                incorporationCountry:
                  type: string
                  description: ISO 3166-1 alfa-3. Solo para COMPANY.
                  examples:
                    - BRA
                website:
                  type: string
                  description: Página web de la empresa. Hasta 255 caracteres.
                  examples:
                    - https://www.example.com
                legalRepresentativeName:
                  type: string
                  description: >-
                    Nombre del representante legal (COMPANY). Hasta 255
                    caracteres.
                  examples:
                    - Jane Doe
                email:
                  type: string
                  description: Correo electrónico de contacto. Hasta 255 caracteres.
                  examples:
                    - test@example.com
                phone:
                  type: object
                  description: Teléfono de contacto, solo dígitos en cada parte.
                  properties:
                    countryCode:
                      type: string
                      description: Código de llamada del país sin + (55), de 1 a 4 dígitos.
                      examples:
                        - '55'
                    areaCode:
                      type: string
                      description: Código de área (11), de 1 a 5 dígitos.
                      examples:
                        - '11'
                    number:
                      type: string
                      description: >-
                        Número local (999990001), de 4 a 15 dígitos. Obligatorio
                        cuando se envía phone.
                      examples:
                        - '999990000'
                address:
                  type: object
                  description: Dirección postal. Si se envía, el país es obligatorio.
                  properties:
                    street:
                      type: string
                      description: Nombre de la calle, hasta 256 caracteres.
                      examples:
                        - Rua Exemplo
                    number:
                      type: string
                      description: Número de calle, hasta 20 caracteres.
                      examples:
                        - '100'
                    line2:
                      type: string
                      description: >-
                        Línea adicional de la dirección (departamento, piso,
                        oficina), hasta 256 caracteres.
                      examples:
                        - Sala 100
                    line3:
                      type: string
                      description: >-
                        Segunda línea adicional de la dirección, de hasta 256
                        caracteres.
                      examples:
                        - Torre A
                    city:
                      type: string
                      description: Ciudad, hasta 100 caracteres.
                      examples:
                        - São Paulo
                    state:
                      type: string
                      description: >-
                        Estado o provincia, hasta 100 caracteres. Utiliza el
                        código ISO 3166-2 (SP).
                      examples:
                        - SP
                    zipCode:
                      type: string
                      description: Código postal, de hasta 20 caracteres.
                      examples:
                        - 01310-100
                    country:
                      type: string
                      description: >-
                        ISO 3166-1 alfa-3. Obligatorio cuando se envía la
                        dirección.
                      examples:
                        - BRA
                    comment:
                      type: string
                      description: >-
                        Información adicional de la dirección (piso,
                        departamento, referencias), hasta 255 caracteres.
                      examples:
                        - Sala 100
                attributes:
                  type: object
                  description: >-
                    Campos personalizados definidos por tu esquema custom-fields
                    (consulta Campos personalizados). Hasta 64 KB.
                document:
                  type: object
                  description: >-
                    El documento que identifica a la entidad (número de
                    identificación fiscal o documento de identidad). Este se
                    convierte en el documento principal. Los demás documentos se
                    añaden posteriormente mediante la opción "Añadir documento".
                  properties:
                    type:
                      type: string
                      description: Consulta Tipos de documentos y comprobantes.
                      enum:
                        - DNI
                        - NATIONAL_ID
                        - DRIVER_LICENSE
                        - PASSPORT
                        - CE
                        - CC
                        - CUIT
                        - CUIL
                        - RFC
                        - CURP
                        - CPF
                        - CNPJ
                        - RUC
                        - NIT
                        - TAX_ID
                        - ARTICLES_OF_INCORPORATION
                        - POWER_OF_ATTORNEY
                        - TAX_CERTIFICATE
                        - PAYSLIP
                        - ARCA_REGISTRATION
                        - PROOF_OF_ADDRESS
                        - PROOF_OF_FUNDS
                        - OTHER
                      examples:
                        - CNPJ
                    id:
                      type: string
                      description: >-
                        Número de documento tal como se emitió, de 1 a 30
                        caracteres. Único junto con el tipo dentro de tu
                        comercio.
                      examples:
                        - '00000000000100'
                    issuingCountry:
                      type: string
                      description: ISO 3166-1 alfa-3.
                      examples:
                        - BRA
                    issueDate:
                      type: string
                      format: date
                      description: AAAA-MM-DD.
                      examples:
                        - '2024-01-15'
                    expirationDate:
                      type: string
                      format: date
                      description: >-
                        AAAA-MM-DD. Una fecha pasada marca el documento como
                        EXPIRED.
                      examples:
                        - '2034-01-15'
                    metadata:
                      type: object
                      description: Metadatos de formato libre del documento.
                  required:
                    - type
                    - id
              required:
                - externalId
                - type
                - name
                - document
            examples:
              Example 1 - INDIVIDUAL:
                value:
                  externalId: 550e8400-e29b-41d4-a716-446655440000
                  type: INDIVIDUAL
                  name: Jane
                  lastname: Doe
                  birthdate: '1990-01-15'
                  nationality: BRA
                  birthCountry: BRA
                  residenceCountry: BRA
                  isPep: false
                  email: jane.doe@example.com
                  phone:
                    countryCode: '55'
                    areaCode: '11'
                    number: '999990001'
                  address:
                    street: Rua Exemplo
                    number: '123'
                    city: São Paulo
                    state: SP
                    zipCode: 01310-100
                    country: BRA
                  document:
                    type: CPF
                    id: '00000000000'
                    issuingCountry: BRA
              Example 2 - COMPANY example:
                value:
                  externalId: f47ac10b-58cc-4372-a567-0e02b2c3d479
                  type: COMPANY
                  name: Example Company S.A.
                  incorporationCountry: BRA
                  incorporationDate: '2020-01-15'
                  website: https://www.example.com
                  email: test@example.com
                  phone:
                    countryCode: '55'
                    areaCode: '11'
                    number: '999990000'
                  legalRepresentativeName: Jane Doe
                  isPep: false
                  address:
                    street: Rua Exemplo
                    number: '100'
                    city: São Paulo
                    state: SP
                    zipCode: 01310-100
                    country: BRA
                    line2: Sala 100
                    line3: Torre A
                  document:
                    type: CNPJ
                    id: '00000000000100'
                    issuingCountry: BRA
                  attributes:
                    reasonForAccountOpening: receive_payments_for_goods_and_services
                    sourceOfFundsAndIncome: sales_of_goods_and_services
                    numberOfEmployees: 11-50
                    estimatedAnnualRevenueUsd: 1m_to_10m
                    estimatedMonthlyVolumeUsd: '50000'
                    businessActivityDescription: >-
                      Online retail of home goods. Receives payments from end
                      customers in Brazil via PIX.
                    countryTaxResidence: BRA
                    socialMedia: https://www.linkedin.com/company/example
                    emailPixKey: test@example.com
      responses:
        '201':
          description: Creado.
          content:
            application/json:
              schema:
                type: object
                properties:
                  internalId:
                    type: string
                    examples:
                      - 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    format: uuid
                    description: >-
                      Identificador de Localpayment de la entidad. Úsalo en
                      todos los demás endpoints de Entidades.
                  externalId:
                    type: string
                    examples:
                      - 550e8400-e29b-41d4-a716-446655440000
                    description: Tu identificador, tal como fue enviado.
                  type:
                    type: string
                    examples:
                      - INDIVIDUAL
                    enum:
                      - INDIVIDUAL
                      - COMPANY
                    description: INDIVIDUAL o COMPANY.
                  status:
                    type: string
                    examples:
                      - PENDING_KYC
                    enum:
                      - PENDING_KYC
                      - IN_REVIEW
                      - ACTIVE
                      - REJECTED
                      - BLOCKED
                      - CLOSED
                    description: >-
                      Estado de la entidad. Consulta Estados de las entidades y
                      códigos de error.
                  name:
                    type: string
                    examples:
                      - Jane
                  lastname:
                    type: string
                    examples:
                      - Doe
                  birthdate:
                    type: string
                    examples:
                      - '1990-01-15'
                    format: date
                  gender:
                    type:
                      - string
                      - 'null'
                  nationality:
                    type: string
                    examples:
                      - BRA
                  birthCountry:
                    type: string
                    examples:
                      - BRA
                  residenceCountry:
                    type: string
                    examples:
                      - BRA
                  occupation:
                    type:
                      - string
                      - 'null'
                  isPep:
                    type: boolean
                    examples:
                      - false
                  incorporationDate:
                    type:
                      - string
                      - 'null'
                    format: date
                  incorporationCountry:
                    type:
                      - string
                      - 'null'
                  website:
                    type:
                      - string
                      - 'null'
                  legalRepresentativeName:
                    type:
                      - string
                      - 'null'
                  email:
                    type: string
                    examples:
                      - jane.doe@example.com
                  phone:
                    type: object
                    properties:
                      countryCode:
                        type: string
                        examples:
                          - '55'
                      areaCode:
                        type: string
                        examples:
                          - '11'
                      number:
                        type: string
                        examples:
                          - '999990001'
                  address:
                    type: object
                    properties:
                      street:
                        type: string
                        examples:
                          - Rua Exemplo
                      city:
                        type: string
                        examples:
                          - São Paulo
                      state:
                        type: string
                        examples:
                          - SP
                      zipCode:
                        type: string
                        examples:
                          - 01310-100
                      number:
                        type: string
                        examples:
                          - '123'
                      comment:
                        type:
                          - string
                          - 'null'
                      country:
                        type: string
                        examples:
                          - BRA
                      line2:
                        type:
                          - string
                          - 'null'
                      line3:
                        type:
                          - string
                          - 'null'
                  attributes:
                    type:
                      - object
                      - 'null'
                  documentationStatus:
                    type: string
                    examples:
                      - NO_FILES
                    enum:
                      - NO_FILES
                      - PARTIAL
                      - COMPLETE
                    description: >-
                      NO_FILES, PARTIAL o COMPLETE: indica si ninguno, algunos o
                      todos los documentos declarados tienen al menos un
                      archivo. Mide la presencia de archivos, no la aprobación.
                  document:
                    type: object
                    properties:
                      documentId:
                        type: string
                        examples:
                          - 2e16d844-4fa9-4295-9a21-83ec32ef241a
                        format: uuid
                      entityId:
                        type: string
                        examples:
                          - 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                        format: uuid
                      type:
                        type: string
                        examples:
                          - CPF
                        enum:
                          - DNI
                          - NATIONAL_ID
                          - DRIVER_LICENSE
                          - PASSPORT
                          - CE
                          - CC
                          - CUIT
                          - CUIL
                          - RFC
                          - CURP
                          - CPF
                          - CNPJ
                          - RUC
                          - NIT
                          - TAX_ID
                          - ARTICLES_OF_INCORPORATION
                          - POWER_OF_ATTORNEY
                          - TAX_CERTIFICATE
                          - PAYSLIP
                          - ARCA_REGISTRATION
                          - PROOF_OF_ADDRESS
                          - PROOF_OF_FUNDS
                          - OTHER
                        description: INDIVIDUAL o COMPANY.
                      id:
                        type: string
                        examples:
                          - '00000000000'
                      issuingCountry:
                        type: string
                        examples:
                          - BRA
                      issueDate:
                        type:
                          - string
                          - 'null'
                        format: date
                      expirationDate:
                        type:
                          - string
                          - 'null'
                        format: date
                      isPrimary:
                        type: boolean
                        examples:
                          - true
                      status:
                        type: string
                        examples:
                          - PENDING
                        enum:
                          - PENDING
                          - VERIFIED
                          - REJECTED
                          - EXPIRED
                        description: >-
                          Estado derivado del documento: EXPIRED si
                          expirationDate ha pasado, REJECTED si alguna prueba
                          activa está rechazada, VERIFIED si todas las pruebas
                          activas están aprobadas; de lo contrario, PENDING.
                      metadata:
                        type:
                          - object
                          - 'null'
                      proofs:
                        type: array
                        items:
                          type: object
                      createdAt:
                        type: string
                        examples:
                          - '2024-01-15T17:03:10Z'
                        format: date-time
                        description: Marcas de tiempo UTC ISO 8601.
                      updatedAt:
                        type: string
                        examples:
                          - '2024-01-15T17:03:10Z'
                        format: date-time
                        description: Marcas de tiempo UTC ISO 8601.
                    description: >-
                      El documento principal con su documentId (necesario para
                      cargar archivos), el estado derivado y las proofs[]
                      actuales.
                  documents:
                    type: array
                    items:
                      type: object
                    description: >-
                      Los demás documentos declarados (el principal está solo en
                      document), con la misma forma.
                  version:
                    type: integer
                    examples:
                      - 0
                    description: >-
                      Versión de la entidad. Es igual al encabezado ETag; se
                      envía de vuelta como If-Match en PATCH.
                  createdAt:
                    type: string
                    examples:
                      - '2024-01-15T17:03:10Z'
                    format: date-time
                    description: Marcas de tiempo UTC ISO 8601.
                  updatedAt:
                    type: string
                    examples:
                      - '2024-01-15T17:03:10Z'
                    format: date-time
                    description: Marcas de tiempo UTC ISO 8601.
                  customFieldSchemaVersion:
                    type:
                      - integer
                      - 'null'
                    description: >-
                      Versión del esquema de campos personalizados utilizado
                      para validar atributos, o nulo.
              examples:
                Example 1:
                  value:
                    internalId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                    externalId: 550e8400-e29b-41d4-a716-446655440000
                    type: INDIVIDUAL
                    status: PENDING_KYC
                    name: Jane
                    lastname: Doe
                    birthdate: '1990-01-15'
                    gender: null
                    nationality: BRA
                    birthCountry: BRA
                    residenceCountry: BRA
                    occupation: null
                    isPep: false
                    incorporationDate: null
                    incorporationCountry: null
                    website: null
                    legalRepresentativeName: null
                    email: jane.doe@example.com
                    phone:
                      countryCode: '55'
                      areaCode: '11'
                      number: '999990001'
                    address:
                      street: Rua Exemplo
                      city: São Paulo
                      state: SP
                      zipCode: 01310-100
                      number: '123'
                      comment: null
                      country: BRA
                      line2: null
                      line3: null
                    attributes: null
                    documentationStatus: NO_FILES
                    document:
                      documentId: 2e16d844-4fa9-4295-9a21-83ec32ef241a
                      entityId: 5aced5da-40c1-4bec-85ff-c8cd1bcb4526
                      type: CPF
                      id: '00000000000'
                      issuingCountry: BRA
                      issueDate: null
                      expirationDate: null
                      isPrimary: true
                      status: PENDING
                      metadata: null
                      proofs: []
                      createdAt: '2024-01-15T17:03:10Z'
                      updatedAt: '2024-01-15T17:03:10Z'
                    documents: []
                    version: 0
                    createdAt: '2024-01-15T17:03:10Z'
                    updatedAt: '2024-01-15T17:03:10Z'
                    customFieldSchemaVersion: null
          headers:
            ETag:
              description: >-
                Versión de la entidad. Devuélvalo como If-Match al actualizar
                una entidad.
              schema:
                type: string
                examples:
                  - '"0"'
        '400':
          description: >-
            Solicitud incorrecta. VALIDATION_ERROR: Falta un campo, encabezado,
            ruta o parámetro de consulta, es desconocido o no válido. details[]
            muestra el campo y el problema. CUSTOM_FIELDS_INVALID: Los atributos
            no cumplen con el esquema de campos personalizados. details[]
            muestra el campo y el problema.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - VALIDATION_ERROR:
                  value:
                    type: about:blank
                    title: Validation error
                    status: 400
                    detail: >-
                      A field, header, path or query parameter is missing,
                      unknown or invalid. details[] lists field and issue.
                    instance: /api/entity/v1/entities
                    code: VALIDATION_ERROR
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details:
                      - field: externalId
                        issue: REQUIRED
                Example 2 - CUSTOM_FIELDS_INVALID:
                  value:
                    type: about:blank
                    title: Validation error
                    status: 400
                    detail: >-
                      attributes does not satisfy your custom-fields schema.
                      details[] lists field and issue.
                    instance: /api/entity/v1/entities
                    code: CUSTOM_FIELDS_INVALID
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details:
                      - field: numberOfEmployees
                        issue: NOT_IN_OPTIONS
        '401':
          description: >-
            No autorizado. UNAUTHORIZED: Falta el token de acceso o no es
            válido.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - UNAUTHORIZED:
                  value:
                    type: about:blank
                    title: Unauthorized
                    status: 401
                    detail: Missing or invalid access token.
                    instance: /api/entity/v1/entities
                    code: UNAUTHORIZED
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '409':
          description: >-
            Conflicto. DUPLICATE_ENTITY: externalId, o el par tipo + id de un
            documento, ya existe en tu comerciante.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - DUPLICATE_ENTITY:
                  value:
                    type: about:blank
                    title: Conflict
                    status: 409
                    detail: >-
                      externalId, or the pair type + id of a document, already
                      exists in your merchant.
                    instance: /api/entity/v1/entities
                    code: DUPLICATE_ENTITY
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '413':
          description: >-
            Carga útil demasiado grande. PAYLOAD_TOO_LARGE: los atributos
            superan los 64 KB.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - PAYLOAD_TOO_LARGE:
                  value:
                    type: about:blank
                    title: Payload too large
                    status: 413
                    detail: attributes exceeds 64 KB.
                    instance: /api/entity/v1/entities
                    code: PAYLOAD_TOO_LARGE
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '415':
          description: >-
            Tipo de medio no compatible. UNSUPPORTED_MEDIA_TYPE: El tipo de
            contenido de la solicitud no es el que espera el endpoint
            (application/json o multipart/form-data para cargas).
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - UNSUPPORTED_MEDIA_TYPE:
                  value:
                    type: about:blank
                    title: Unsupported media type
                    status: 415
                    detail: >-
                      The request Content-Type is not the one the endpoint
                      expects (application/json, or multipart/form-data for
                      uploads).
                    instance: /api/entity/v1/entities
                    code: UNSUPPORTED_MEDIA_TYPE
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
        '422':
          description: >-
            Entidad no procesable. INCOMPLETE_KYC_DATA: Faltan los datos KYC
            mínimos: name y lastname para INDIVIDUAL, name para COMPANY.
          content:
            application/problem+json:
              schema:
                type: object
                description: >-
                  Detalles del problema según RFC 9457
                  (application/problem+json).
                properties:
                  type:
                    type: string
                    examples:
                      - about:blank
                  title:
                    type: string
                    description: Breve resumen del problema.
                  status:
                    type: integer
                    description: Código de estado HTTP.
                  detail:
                    type: string
                    description: Explicación comprensible para el ser humano.
                  instance:
                    type: string
                    description: Ruta de solicitud.
                  code:
                    type: string
                    description: >-
                      Código de error estable legible por máquina. Basa tu
                      lógica de ramificación en este valor.
                  correlationId:
                    type: string
                    format: uuid
                    description: >-
                      Identificador de la solicitud. Indícalo cuando te pongas
                      en contacto con el servicio de asistencia.
                    examples:
                      - 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                  details:
                    type: array
                    description: Campos problemáticos, cuando corresponda.
                    items:
                      type: object
                      properties:
                        field:
                          type: string
                          examples:
                            - numberOfEmployees
                        issue:
                          type: string
                          examples:
                            - NOT_IN_OPTIONS
              examples:
                Example 1 - INCOMPLETE_KYC_DATA:
                  value:
                    type: about:blank
                    title: Unprocessable entity
                    status: 422
                    detail: >-
                      Minimum KYC data is missing: name and lastname for
                      INDIVIDUAL, name for COMPANY.
                    instance: /api/entity/v1/entities
                    code: INCOMPLETE_KYC_DATA
                    correlationId: 0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10
                    details: []
      security:
        - token: []
components:
  securitySchemes:
    token:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.