[All schemas](/reference/schemas/) · [API reference](/reference/) · [Data mapping guide](/guides/data-model/)

## Fields

| Field | Required | Type / allowed values |
| --- | --- | --- |
| `id` | Yes | string |
| `documentType` | Yes | string |
| `documentNumber` | Yes | string |
| `userType` | Yes | string or null |
| `birthDate` | Yes | string or null |
| `sexCode` | Yes | string or null |
| `countryResidenceCode` | Yes | string or null |
| `countryOriginCode` | Yes | string or null |
| `municipalityResidenceCode` | Yes | string or null |
| `territorialZoneCode` | Yes | string or null |
| `disabilityFlag` | Yes | string or null |
| `incapacityCertificate` | Yes | `SI`, `NO`, `null` |
| `registroSiras` | Yes | string or null |
| `firstName` | Yes | string |
| `middleName` | Yes | string or null |
| `lastName` | Yes | string |
| `secondLastName` | Yes | string or null |
| `isActive` | Yes | boolean |
| `createdAt` | Yes | string |
| `updatedAt` | Yes | string |

## JSON definition

The JSON retains the source contract descriptions. Do not translate property names or enum values.

```json
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "documentType": {
      "type": "string"
    },
    "documentNumber": {
      "type": "string"
    },
    "userType": {
      "type": [
        "string",
        "null"
      ]
    },
    "birthDate": {
      "type": [
        "string",
        "null"
      ]
    },
    "sexCode": {
      "type": [
        "string",
        "null"
      ]
    },
    "countryResidenceCode": {
      "type": [
        "string",
        "null"
      ]
    },
    "countryOriginCode": {
      "type": [
        "string",
        "null"
      ]
    },
    "municipalityResidenceCode": {
      "type": [
        "string",
        "null"
      ]
    },
    "territorialZoneCode": {
      "type": [
        "string",
        "null"
      ]
    },
    "disabilityFlag": {
      "type": [
        "string",
        "null"
      ]
    },
    "incapacityCertificate": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "SI",
        "NO",
        null
      ]
    },
    "registroSiras": {
      "type": [
        "string",
        "null"
      ]
    },
    "firstName": {
      "type": "string"
    },
    "middleName": {
      "type": [
        "string",
        "null"
      ]
    },
    "lastName": {
      "type": "string"
    },
    "secondLastName": {
      "type": [
        "string",
        "null"
      ]
    },
    "isActive": {
      "type": "boolean"
    },
    "createdAt": {
      "type": "string",
      "description": "Fecha y hora ISO 8601 (UTC).",
      "example": "2026-10-15T12:00:00.000Z"
    },
    "updatedAt": {
      "type": "string",
      "description": "Fecha y hora ISO 8601 (UTC).",
      "example": "2026-10-15T12:00:00.000Z"
    }
  },
  "required": [
    "id",
    "documentType",
    "documentNumber",
    "userType",
    "birthDate",
    "sexCode",
    "countryResidenceCode",
    "countryOriginCode",
    "municipalityResidenceCode",
    "territorialZoneCode",
    "disabilityFlag",
    "incapacityCertificate",
    "registroSiras",
    "firstName",
    "middleName",
    "lastName",
    "secondLastName",
    "isActive",
    "createdAt",
    "updatedAt"
  ]
}
```