Listar documentos invitados

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.

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.

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

Cada documento tiene la misma estructura que en Mostrar un documento. Aquí se muestran solo algunos atributos.

{
  "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.