# Listar documentos invitados

Fuente: /document-management/list-invited-documents/

Este endpoint lista los documentos en los que apareces como firmante, sin importar quién los creó ni en qué carpeta de trabajo están. Acepta el mismo filtro de estado que [Listar documentos por estado](/document-management/list-documents).

**Método:**  GET `https://api.digitafirma.com/v1/documents/invited`

### Query Parameters

| Campo | Tipo | Requerido | Descripción |
| :- | :- | :- | :- |
| `searchName` | `string` | Sí | Texto que debe contener el nombre del archivo. Envíalo vacío (`searchName=`) para no filtrar por nombre. |
| `sign_status` | `integer` | No | Estado de firma del documento: `1` sin firmar, `2` firmado parcialmente, `3` firmado, `4` rechazado. Puedes enviar varios. Si lo omites, regresa todos los estados. |
| `page` | `integer` | No | Página a consultar. Empieza en `0`. |
| `size` | `integer` | No | Documentos por página. Por defecto `20`. |

Este endpoint no recibe `company_id`: busca en todas las cuentas y carpetas.

***

### Qué incluye el listado

**Por correo del firmante**

Aparecen los documentos donde algún firmante tiene el mismo correo que el usuario de la `X-Api-Key`. Incluye los que tú creaste si también eres firmante; en esos, `isOwner` viene en `true`.

**El estado es del documento**

`sign_status` filtra por el estado **del documento**, no por tu firma. Un documento `2` (parcial) puede estar pendiente para ti o ya firmado por ti y pendiente para otros.

**Sin archivados ni eliminados**

Si quien creó el documento lo archivó o lo eliminó, deja de aparecer aquí.

**Paginado**

La paginación funciona igual que en [Listar documentos por estado](/document-management/list-documents#paginación).

> **¿Cuáles me faltan por firmar?**
>
> Filtra con `sign_status=1&sign_status=2` y, en cada documento, busca tu correo en `relationships.signatories.data[]`. Te falta firmar si tu `sign_status` ahí es `PENDING`; si es `SIGNED` ya firmaste y si es `REJECTED` lo rechazaste.

***

### Ejemplo de integración

**curl**

```bash
curl --location 'https://api.digitafirma.com/v1/documents/invited?searchName=&sign_status=1&sign_status=2' \
--header 'X-Api-Key: {X-API-KEY}'
```

**Respuesta Exitosa (200 OK)**

Cada documento tiene la misma estructura que en [Mostrar un documento](/document-management/show-document). Aquí se muestran solo algunos atributos.

```json
{
  "data": [
    {
      "type": "documents",
      "id": "ac110005-9df4-1d1b-819d-f60440bc003c",
      "links": {
        "self": "/documents/ac110005-9df4-1d1b-819d-f60440bc003c"
      },
      "attributes": {
        "file_name": "contrato-servicios.pdf",
        "sign_status": 2,
        "signed": false,
        "owner": "Juan Pérez <juan.perez@ejemplo.com>",
        "isOwner": false,
        "created_at": "2026-05-04T20:42:47.172839"
      },
      "relationships": {
        "signatories": {
          "data": [
            {
              "type": "signatures",
              "id": "ac110005-9df4-1d1b-819d-f60440c7003d",
              "attributes": {
                "name": "María López",
                "email": "maria.lopez@ejemplo.com",
                "sign_status": "PENDING"
              }
            }
          ]
        }
      }
    }
  ],
  "meta": [
    {
      "page": {
        "total": 1,
        "initialItem": 0,
        "totalItems": 1
      }
    }
  ],
  "links": {
    "self": "/documents"
  }
}
```

***

### Errores comunes

| Código | Mensaje | Causa |
| :- | :- | :- |
| 400 | — | Falta `searchName` en la petición. |
| 401 | — | Falta la `X-Api-Key` o no es válida. |