# doculisto

> API-first electronic signature for Mexico: PDF templates, documents to sign created from your own system (by link, embedded in your app, or entirely by API, including one signature applied to many copies), sealed with a PAdES signature and an audit certificate.

Guides are in Spanish; the API reference is in English. Sandbox keys (`fk_test_…`) are free from the home page and create up to 10 watermarked documents.

## Docs

- [Full documentation](https://doculisto.mx/llms-full.txt): every guide and endpoint, with request and response schemas, in one Markdown file
- [OpenAPI 3.1 document](https://doculisto.mx/openapi.json): machine-readable API description
- [API reference](https://doculisto.mx/docs): the same content, for people

## Endpoints

- `GET /v1/templates`: List templates
- `POST /v1/templates`: Upload a PDF
- `GET /v1/templates/{id}`: Get a template
- `GET /v1/templates/{id}/document`: Download the template PDF
- `PUT /v1/templates/{id}/draft`: Set roles and fields
- `POST /v1/templates/{id}/publish`: Publish the draft
- `GET /v1/sandbox/templates`: List sandbox templates
- `POST /v1/templates/import`: Import a template from the sandbox
- `POST /v1/envelopes`: Create an envelope
- `GET /v1/envelopes`: List envelopes
- `GET /v1/envelopes/{id}`: Get an envelope
- `POST /v1/envelopes/{id}/send`: Start signing
- `POST /v1/envelopes/{id}/void`: Void an envelope
- `GET /v1/envelopes/{id}/document`: Download a PDF
- `GET /v1/envelopes/{id}/evidence`: Get the evidence
- `POST /v1/envelopes/{id}/recipients/{role}/embed`: Create an embed token
- `POST /v1/envelopes/{id}/recipients/{role}/sign`: Sign through the API
- `POST /v1/envelopes/{id}/recipients/{role}/otp`: Send the signer a code
- `POST /v1/masters`: Create a master
- `GET /v1/masters`: List masters
- `GET /v1/masters/{id}`: Get a master
- `POST /v1/masters/{id}/envelopes`: Create envelopes from a master
- `GET /v1/masters/{id}/envelopes`: List a master's envelopes
- `POST /v1/masters/{id}/close`: Close a master
- `POST /v1/masters/{id}/reopen`: Reopen a master
- `PUT /v1/masters/{id}/public-link`: Turn the public link on or off
- `GET /v1/webhooks`: List webhooks
- `POST /v1/webhooks`: Create a webhook
- `GET /v1/webhooks/{id}`: Get a webhook
- `PATCH /v1/webhooks/{id}`: Update a webhook
- `DELETE /v1/webhooks/{id}`: Delete a webhook
- `POST /v1/webhooks/{id}/rotate-secret`: Rotate the secret
- `POST /v1/webhooks/{id}/test`: Send a test event
- `GET /v1/webhooks/{id}/deliveries`: List deliveries
- `POST /v1/webhooks/{id}/deliveries/{delivery_id}/retry`: Retry a delivery
- `GET /v1/organization`: Get the organization
- `GET /v1/settings/embed-origins`: List embed origins
- `PUT /v1/settings/embed-origins`: Set embed origins

## Optional

- [Get a sandbox key](https://doculisto.mx/#sandbox): emailed at once, up to 10 test documents