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

# Crear y Enviar Solicitud de Firma

> Crea una nueva solicitud de firma y la envía inmediatamente a los firmantes

## Autenticación

> [!NOTE]
>
> **¿Todavía no tienes un API token?** El campo `Authorization` del panel **Try it** espera tu token Bearer. Revisa [dónde obtener tu API token](https://developers.verifica.id/api-reference/authentication.md#dónde-obtener-tu-api-token) para conseguirlo.

Este endpoint requiere autenticación Bearer. Incluye tu API key en el header Authorization (si aún no sabes cómo obtener y usar tu API key, consulta la página de [Autenticación](https://developers.verifica.id/api-reference/authentication.md)):

```
Authorization: Bearer YOUR_API_KEY
```

## Cuerpo de la Solicitud

**name** `string` *required*

Nombre de la solicitud de firma (máximo 255 caracteres)

**expires\_at** `string`

Fecha y hora de expiración (formato ISO 8601). Requerido sin `expires_in`. Debe ser al menos 10 minutos en el futuro.

**expires\_in** `integer`

Minutos hasta la expiración. Requerido sin `expires_at`. Mínimo: 1, Máximo: 43200

**documents** `array` *required*

Lista de documentos a firmar (mínimo 1)

**propiedades de documento**

**name** `string` *required*

Nombre del documento (máximo 255 caracteres)

**file** `string` *required*

Archivo PDF codificado en Base64

**signers** `array` *required*

Lista de firmantes (mínimo 1)

**propiedades de firmante**

**full\_name** `string` *required*

Nombre completo del firmante (máximo 255 caracteres)

**document\_type** `string` *required*

Tipo de documento: `dni`, `ce`, o `passport`

**document\_number** `string` *required*

Número de documento (máximo 30 caracteres)

**email** `string` *required*

Correo electrónico del firmante (máximo 255 caracteres)

**phone** `string`

Teléfono del firmante (máximo 20 caracteres)

## Respuesta

**status** `string`

Estado de la respuesta (ej: "success")

**message** `string`

Mensaje de respuesta

**data** `object`

Datos de respuesta

**propiedades de data**

**signature** `object`

Objeto de la solicitud de firma creada

**propiedades de signature**

**id** `string`

UUID de la solicitud de firma

**organization\_id** `integer | null`

ID de la organización

**name** `string`

Nombre de la solicitud de firma

**status** `string`

Estado de la firma

**status\_name** `string`

Nombre del estado en formato legible

**created\_at** `string`

Fecha y hora de creación

**expiration\_date** `string | null`

Fecha y hora de expiración

**completed\_at** `string | null`

Fecha y hora de completado

**rejected\_at** `string | null`

Fecha y hora de rechazo

**rejected\_reason** `string | null`

Motivo del rechazo

**rejected\_by** `string | null`

Quién rechazó la firma

**documents** `array`

Lista de documentos

**signers** `array`

Lista de firmantes con sus detalles

## Ejemplo de Solicitud

```json theme={null}
{
  "name": "Contrato de Servicios 2024",
  "expires_in": 10080,
  "documents": [
    {
      "name": "Contrato.pdf",
      "file": "JVBERi0xLjQKJeLjz9MKMyAwIG9iago..."
    }
  ],
  "signers": [
    {
      "full_name": "Juan Pérez",
      "document_type": "dni",
      "document_number": "12345678",
      "email": "juan.perez@example.com",
      "phone": "+51999999999"
    },
    {
      "full_name": "María García",
      "document_type": "ce",
      "document_number": "87654321",
      "email": "maria.garcia@example.com"
    }
  ]
}
```

## Ejemplo de Respuesta

```json theme={null}
{
  "status": "success",
  "message": "Signature created successfully.",
  "data": {
    "signature": {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "organization_id": 1,
      "name": "Contrato de Servicios 2024",
      "status": "sent",
      "status_name": "Enviado",
      "created_at": "2024-01-15T10:30:00Z",
      "expiration_date": "2024-01-22T10:30:00Z",
      "completed_at": null,
      "rejected_at": null,
      "rejected_reason": null,
      "rejected_by": null,
      "documents": [],
      "signers": []
    }
  }
}
```


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