# BoloSign Developer Docs Documentation

> Documentation for BoloSign Developer Docs

Append .md to any documentation page URL to get its markdown version.

## Guides
- [Documentation](https://bolosign-developer-docs.readme.io/docs.md): BoloSign Developer Docs documentation

## API Reference
- [Getting Started](https://bolosign-developer-docs.readme.io/reference/getting-started.md): Set up the welcome page for your API to help users make their first call.
- [Authentication](https://bolosign-developer-docs.readme.io/reference/authentication.md): Set up the welcome page for your API to help users make their first call.
- [My Requests](https://bolosign-developer-docs.readme.io/reference/my-requests.md): Set up the welcome page for your API to help users make their first call.
- [Get documents list](https://bolosign-developer-docs.readme.io/reference/getdocuments.md): Retrieve documents for a workspace, with optional filtering and pagination.  A document is either a **single signature PDF** (`documentType=PDF`) or a **PDF template** (`documentType=PDF_TEMPLATE`). Both types are supported; set `documentType` to choose which list to return. Default is `PDF`.  Results are always sorted by `createdAt`. Use `sortOrder` for ascending or descending (default: newest first).  Supported filters: `documentType`, `status` (PDF only), `documentId`, `dateFrom` / `dateTo` (`createdAt` range), and `archive`. Maximum `limit` is 100.
- [Void a document](https://bolosign-developer-docs.readme.io/reference/voiddocument.md): Voids an in-progress document. Works for both **single signature PDFs** (`documentType=PDF`) and **PDF templates** (`documentType=PDF_TEMPLATE`). Idempotent: already-voided documents return 200 with `Document is already voided`.  For a single signature PDF, send the public `documentId` UUID (`documentType` defaults to `PDF`). For a PDF template, send the template UUID as `documentId`, set `documentType` to `PDF_TEMPLATE`, and pass the respondent Mongo ObjectId (`createdDocumentId` from `/pdf-template-lambda`) as `responseId`.  Documents in `SIGNED`, `PAID`, `DECLINED`, `EXPIRED`, or `DELETED` cannot be voided.
- [Send reminder to pending signers](https://bolosign-developer-docs.readme.io/reference/sendreminder.md): Sends reminder emails/SMS to pending signers on a document. Works for both **single signature PDFs** (`documentType=PDF`) and **PDF templates** (`documentType=PDF_TEMPLATE`). Respects signing order if configured. Rate limited to 5 requests per 15 minutes per API key.  For a single signature PDF, send the public `documentId` UUID (`documentType` defaults to `PDF`). For a PDF template, send the template UUID as `documentId`, set `documentType` to `PDF_TEMPLATE`, and pass the respondent Mongo ObjectId (`createdDocumentId` from `/pdf-template-lambda`) as `responseId`.  Reminders are rejected for documents in `SIGNED`, `VOID`, `EXPIRED`, `DECLINED`, or `DELETED`.
- [Create or send a template PDF document](https://bolosign-developer-docs.readme.io/reference/sendtemplateforsigning.md): Create / send a template PDF document for signing (also supports form templates).  This is the public route for creating a signing request from a template. Set `signingType` to `PDF_TEMPLATE` to send a PDF template, or `FORM_TEMPLATE` to send a form template. Supply receivers, optional custom variables, and optional `mailData`.  For `PDF_TEMPLATE`, each receiver `roleTitle` must exactly match a role on the template in the BoloSign dashboard. The `createdDocumentId` in the PDF response is the Mongo ObjectId to pass as `responseId` to `/void-document` and `/send-reminder` when `documentType=PDF_TEMPLATE`.
- [Get template respondents](https://bolosign-developer-docs.readme.io/reference/gettemplaterespondents.md): Retrieve respondents for a specific template with pagination, or get a specific respondent.  Provide `templateId`, `respondentDocumentId`, or both. `respondentDocumentId` is the Mongo ObjectId returned as `createdDocumentId` from `POST /pdf-template-lambda` and `templateRespondents` array in the response of `GET /get-documents`.
- [Get form responses](https://bolosign-developer-docs.readme.io/reference/getformresponses.md): Retrieve form responses.  Provide `formId`, `responseId`, or both. `responseId` may be a Mongo ObjectId or a UUID v4 (`formResponseId`). Pagination (`page`, `limit`) applies when listing by `formId` only.
- [BoloSign Webhooks API Documentation](https://bolosign-developer-docs.readme.io/reference/bolosign-webhooks-api-documentation-2.md)
- [BoloSign Embed Documentation](https://bolosign-developer-docs.readme.io/reference/bolosign-embed-documentation.md): BoloSign’s embed feature enables seamless integration of digital signature functionality into your website or application, streamlining document workflows and improving client signing experiences.