Skip to main content
Listar los documentos creados por un usuario de la organización

Authorizations

X-API-Key
string
header
required

API key de tu organización, con formato fma_live_<publicId>_<secret>. Se emite (y se rota o revoca) desde Integraciones en Firmalo; el secreto completo sólo se muestra al emitirla.

Ejemplo (no es una llave real): fma_live_0123456789abcdef_EjemploNoRealEjemploNoRealEjemploNoReal1234

La organización y el contexto de acceso salen de la llave: no se usan JWT, X-Account-Id ni X-Organization-Id. Llama a la API sólo desde tu backend; nunca expongas la llave en un navegador o una app móvil.

Path Parameters

userId
string<uuid>
required

users.id del creador

Example:

"9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"

Query Parameters

statuses
enum<string>[]

Uno o varios estatus del documento. Repetible (?statuses=pending&statuses=signed) o separado por comas.

Available options:
CREATED,
PENDING_APPROVAL,
PENDING_SIGNATURE,
SIGNED,
REJECTED,
EXPIRED,
CANCELLATION_PENDING,
CANCELLED
createdFrom
string

Creados desde (ISO 8601)

Example:

"2026-01-01"

createdTo
string

Creados hasta (ISO 8601)

Example:

"2026-12-31"

signedFrom
string

Firmados desde (ISO 8601)

Example:

"2026-01-01"

signedTo
string

Firmados hasta (ISO 8601)

Example:

"2026-12-31"

sortBy
enum<string>
default:createdAt

Campo por el que se ordena. Lista cerrada, no un nombre de columna.

Available options:
createdAt,
signedAt,
fileName,
status
sortDirection
enum<string>
default:DESC
Available options:
ASC,
DESC
page
number
default:1

Página

Required range: x >= 1
limit
number
default:25

Resultados por página

Required range: 1 <= x <= 100

Response

Página de documentos del usuario

success
boolean
required

Indica si la operación fue exitosa

Example:

true

message
enum<string>
required

Mensaje descriptivo del resultado de la operación

Available options:
Operación realizada con éxito,
Recurso creado correctamente,
Recurso no encontrado,
Datos de entrada inválidos,
No autorizado para realizar esta acción,
El firmante no está asociado al recurso,
El recurso ya existe,
Error interno del servidor
Example:

"Operación realizada con éxito"

data
object
required

Datos de la respuesta