# Firmeasy API Documentation

> Official documentation for integrating electronic and digital signatures with legal validity through the Firmeasy REST API, compliant with INDECOPI (Peru) + PKI infrastructure.

## Getting Started

- [Connection Guide](https://docs.firmeasy.legal/en/guides/example): Quick start with API keys, base URL, and first request
- [Authentication - JWT](https://docs.firmeasy.legal/en/autenticacion/2auth_jwt): Obtain and refresh JWT access tokens via OAuth 2.0

## Documents API

- [Create Document (Sync)](https://docs.firmeasy.legal/en/documentos/crear_documento_sync): POST /api/v1/documents — create a document envelope synchronously
- [Create Document (Async)](https://docs.firmeasy.legal/en/documentos/crear_documento_async): POST /api/v1/documents/async — batch processing for large files
- [Get Document](https://docs.firmeasy.legal/en/documentos/obtener_documento): GET /api/v1/documents/{token} — retrieve envelope details
- [List Documents](https://docs.firmeasy.legal/en/documentos/listar_documento): GET /api/v1/documents — paginated listing with filters
- [Delete Document](https://docs.firmeasy.legal/en/documentos/eliminar_documento): DELETE /api/v1/documents/{token} — remove an envelope
- [Ingestion Status](https://docs.firmeasy.legal/en/documentos/estado_ingesta): GET /api/v1/documents/{token}/status — check processing status
- [Cancel Ingestion](https://docs.firmeasy.legal/en/documentos/cancelar_ingesta): POST /api/v1/documents/{token}/cancel — cancel async ingestion

## Folders

- [Create Folder](https://docs.firmeasy.legal/en/folders/1guardar_folder): POST /api/v1/folders
- [Get Folder](https://docs.firmeasy.legal/en/folders/2obtener_folder): GET /api/v1/folders/{token}
- [List Folders](https://docs.firmeasy.legal/en/folders/3listar_folder): GET /api/v1/folders
- [Update Folder](https://docs.firmeasy.legal/en/folders/4actualizar_folder): PATCH /api/v1/folders/{token}

## Webhooks

- [Create Webhook](https://docs.firmeasy.legal/en/webhooks/crear_webhook): POST /api/v1/webhooks
- [Get Webhook](https://docs.firmeasy.legal/en/webhooks/obtener_webhook): GET /api/v1/webhooks/{token}
- [List Webhooks](https://docs.firmeasy.legal/en/webhooks/listar_webhook): GET /api/v1/webhooks
- [Delete Webhook](https://docs.firmeasy.legal/en/webhooks/eliminar_webhook): DELETE /api/v1/webhooks/{token}

## Events

- [Event Reference](https://docs.firmeasy.legal/en/webhooks/eventos/eventos): All available webhook events and payloads

## Digital Signature

- [Create Digital Folder](https://docs.firmeasy.legal/en/digital/1carpeta): Create a digital signature folder
- [Digital Folder Link](https://docs.firmeasy.legal/en/digital/2enlace_carpeta): Generate digital signature folder links
- [Digital Signature File](https://docs.firmeasy.legal/en/digital/3archivo_dig): Upload files for digital signing
- [Download Digital File](https://docs.firmeasy.legal/en/digital/4descarga_archivo): Download signed digital documents
- [Digital File Link](https://docs.firmeasy.legal/en/digital/5enlace_archivo): Generate digital file access links
- [Check Digital File](https://docs.firmeasy.legal/en/digital/6consulta_archivo): Query digital file status

## Electronic Signature

- [Create Electronic Folder](https://docs.firmeasy.legal/en/electronico/1carpeta): Create an electronic signature folder
- [Create Signer](https://docs.firmeasy.legal/en/electronico/2crearfirmante): Add signers to electronic signature flow
- [Electronic Signature File](https://docs.firmeasy.legal/en/electronico/3archivo_electronico): Upload files for electronic signing
- [Download Electronic File](https://docs.firmeasy.legal/en/electronico/4descarga_archivo): Download signed electronic documents
- [Check Electronic File](https://docs.firmeasy.legal/en/electronico/5consulta_archivo): Query electronic file status
- [Update Electronic File](https://docs.firmeasy.legal/en/electronico/6actualizar): Update electronic signing parameters
- [Delete Electronic File](https://docs.firmeasy.legal/en/electronico/7eliminar): Remove electronic signature files
- [Get Electronic File](https://docs.firmeasy.legal/en/electronico/8get): Retrieve electronic signature details

## SDKs

- [Node.js SDK](https://docs.firmeasy.legal): @firmeasy/sdk — npm package
- [Python SDK](https://docs.firmeasy.legal): firmeasy — pip package
- [PHP SDK](https://docs.firmeasy.legal): firmeasy/sdk — Composer package
- [Go SDK](https://docs.firmeasy.legal): github.com/firmeasy/sdk-go — Go module