Suresign REST API: read documents and download signed PDFs

The Suresign REST API lets your own software read the documents in your workspace and download their PDFs. Use it to copy completed agreements into your file storage, attach them to a customer record, or build a report of what is signed and what is still waiting. The API is read-only: sending, signing and the agent all happen in the Suresign app.

The API is available on the Pro and Business plans and uses workspace API keys.

Base URL

https://suresign.si/api/v1

Every request needs an Authorization: Bearer dtd_... header. See Authentication.

Endpoints

Method and path	What it does
`GET /api/v1/me`	Shows which workspace and key you are using, with a count of documents by status
`GET /api/v1/documents`	Lists documents, newest first, with an optional `status` filter
`GET /api/v1/documents/{id}`	Gets one document, its recipients, and what each person is asked to do
`GET /api/v1/documents/{id}/download`	Downloads the signed PDF, the original upload, or the certificate

Full request and response details are in the API Reference section of the sidebar.

Pagination

GET /api/v1/documents uses cursor pagination. Ask for up to 100 documents at a time with limit (default 25). If there are more, the response includes a nextCursor. Pass it as cursor to get the next page. When nextCursor is null, you have everything.

List completed documents

curl "https://suresign.si/api/v1/documents?status=COMPLETED&limit=50" \
  -H "Authorization: Bearer $SURESIGN_API_KEY"

Response (shortened)

{
  "data": [
    {
      "id": "doc_123",
      "title": "Northwind Studio NDA",
      "status": "COMPLETED",
      "signingOrder": "PARALLEL",
      "progress": { "done": 1, "total": 1 },
      "recipients": [
        { "name": "Dana Lee", "email": "dana@example.com", "role": "SIGNER", "status": "SIGNED" }
      ],
      "links": {
        "self": "/api/v1/documents/doc_123",
        "download": "/api/v1/documents/doc_123/download"
      }
    }
  ],
  "nextCursor": null
}

Downloads

GET /api/v1/documents/{id}/download returns a PDF. Choose the file with type:

`type`	File
`signed`	The sealed, signed PDF. This is the default once the document is complete
`original`	The file as it was uploaded. This is the default before completion
`certificate`	The certificate of completion

Asking for signed or certificate before everyone has finished returns 404 with a message saying the document is not complete. Every API download is recorded in the document’s audit trail under the name of your API key.

Limits and errors

Rate limit: 300 requests per minute per key. Going over returns 429.
Deleted documents never appear in the API.
A document from another workspace returns 404, the same as one that does not exist.
Errors are JSON with an error message. See the error table in Authentication.

A common pattern

Wait for a webhook

Your webhook endpoint receives document.completed.

Download the signed PDF

Call GET /api/v1/documents/{id}/download with the document ID from the event.

Store it

Save the PDF, and the certificate if you want it, in your own system.

Next steps

Authentication

Create your API key.

Webhooks

Get told when documents change.

Get Started

Integrations

API Reference

Suresign REST API: read documents and download signed PDFs

Base URL

Endpoints

Downloads

Limits and errors

A common pattern

Next steps

Authentication

Webhooks

​Base URL

​Endpoints

​Pagination

​Downloads

​Limits and errors

​A common pattern

​Next steps

Authentication

Webhooks

Base URL

Endpoints

Pagination

Downloads

Limits and errors

A common pattern

Next steps