# Formable API

## Docs

- [Get billing data](https://docs.formabledocs.com/api-reference/billing/get-billing-data.md): Returns usage information for the authenticated client's organization.
- [Create a redline request](https://docs.formabledocs.com/api-reference/endpoint/create-redline-request.md): Creates a new redline request for a template with specified members. Each member must have an email, displayName, and role. The template must have a DOCX source file available for redlining.
- [Create a redline URL](https://docs.formabledocs.com/api-reference/endpoint/create-redline-url.md): Generates a redline URL for a specific member of a redline request. The member must already be part of the redline request. The URL opens the redlining editor for that member's turn.
- [Create a signature request](https://docs.formabledocs.com/api-reference/endpoint/create-signature-request.md): Creates a new signature request from a template. Requires a templateId, a signer (email and name), and a sender (email and name). Optionally accepts a fields array to pre-fill template fields before sending.
- [Create a signing URL](https://docs.formabledocs.com/api-reference/endpoint/create-signing-url.md): Generates a signing URL for a signature request. The URL can be embedded in an iframe or shared directly so the signer can complete the document. Signing URLs expire 1 hour after creation.
- [Create a template](https://docs.formabledocs.com/api-reference/endpoint/create-template.md): Upload a PDF or DOCX file to create a new template. The file must be under 40MB and be either a PDF, DOC, or DOCX file.
- [Create a template edit URL](https://docs.formabledocs.com/api-reference/endpoint/create-template-edit-url.md): Generates an edit URL for a template. The URL can be used to access the template editor interface, where you can place and configure fields. The client must be authorized to edit the template.
- [Get billing data](https://docs.formabledocs.com/api-reference/endpoint/get-billing.md): Returns usage information for the authenticated client's organization.
- [Get a redline request](https://docs.formabledocs.com/api-reference/endpoint/get-redline-request.md): Retrieves a single redline request by ID.
- [Get redline request events](https://docs.formabledocs.com/api-reference/endpoint/get-redline-request-events.md): Retrieves the chronological list of events for a redline request, such as turn changes and review requests.
- [Get a signature request](https://docs.formabledocs.com/api-reference/endpoint/get-signature-request.md): Retrieves a single signature request by ID.
- [Get signature request events](https://docs.formabledocs.com/api-reference/endpoint/get-signature-request-events.md): Retrieves the chronological list of events for a signature request, such as creation, sending, and completion.
- [Get a signed envelope](https://docs.formabledocs.com/api-reference/endpoint/get-signed-envelope.md): Retrieves a presigned URL for the signed document associated with a signature request. The signature request must be completed before the signed envelope is available.
- [Health check](https://docs.formabledocs.com/api-reference/endpoint/health-check.md): Returns the health status of the API server, including uptime and version information. This endpoint does not require authentication.
- [List redline requests](https://docs.formabledocs.com/api-reference/endpoint/list-redline-requests.md): Returns all redline requests for the authenticated client's organization, newest updated first. Optionally pass updatedSince to return only requests updated strictly after that instant (ISO-8601).
- [List signature requests](https://docs.formabledocs.com/api-reference/endpoint/list-signature-requests.md): Returns all signature requests for the authenticated client's organization, newest first. Optionally pass updatedSince to return only requests updated strictly after that instant (ISO-8601).
- [Update redline members](https://docs.formabledocs.com/api-reference/endpoint/put-redline-members.md): Replaces or upserts the members for an existing redline request. Each member must have an email, displayName, and role.
- [Health check](https://docs.formabledocs.com/api-reference/health/health-check.md): Returns the health status of the API server, including uptime and version information. This endpoint does not require authentication.
- [API reference](https://docs.formabledocs.com/api-reference/introduction.md): REST endpoints for templates, signature requests, and redlining.
- [Create a redline request](https://docs.formabledocs.com/api-reference/redlining/create-a-redline-request.md): Creates a new redline request for a template with specified members. Each member must have an email, displayName, and role. The template must have a DOCX source file available for redlining.
- [Create a redline URL](https://docs.formabledocs.com/api-reference/redlining/create-a-redline-url.md): Generates a redline URL for a specific member of a redline request. The member must already be part of the redline request. The URL opens the redlining editor for that member's turn.
- [Get a redline request](https://docs.formabledocs.com/api-reference/redlining/get-a-redline-request.md): Retrieves a single redline request by ID.
- [Get redline request events](https://docs.formabledocs.com/api-reference/redlining/get-redline-request-events.md): Retrieves the chronological list of events for a redline request, such as turn changes and review requests.
- [List redline requests](https://docs.formabledocs.com/api-reference/redlining/list-redline-requests.md): Returns all redline requests for the authenticated client's organization, newest updated first. Optionally pass updatedSince to return only requests updated strictly after that instant (ISO-8601).
- [Update redline members](https://docs.formabledocs.com/api-reference/redlining/update-redline-members.md): Replaces or upserts the members for an existing redline request. Each member must have an email, displayName, and role.
- [Create a signature request](https://docs.formabledocs.com/api-reference/signature-requests/create-a-signature-request.md): Creates a new signature request from a template. Requires a templateId, a signer (email and name), and a sender (email and name). Optionally accepts a fields array to pre-fill template fields before sending.
- [Create a signing URL](https://docs.formabledocs.com/api-reference/signature-requests/create-a-signing-url.md): Generates a signing URL for a signature request. The URL can be embedded in an iframe or shared directly so the signer can complete the document. Signing URLs expire 1 hour after creation.
- [Get a signature request](https://docs.formabledocs.com/api-reference/signature-requests/get-a-signature-request.md): Retrieves a single signature request by ID.
- [Get a signed envelope](https://docs.formabledocs.com/api-reference/signature-requests/get-a-signed-envelope.md): Retrieves a presigned URL for the signed document associated with a signature request. The signature request must be completed before the signed envelope is available.
- [Get signature request events](https://docs.formabledocs.com/api-reference/signature-requests/get-signature-request-events.md): Retrieves the chronological list of events for a signature request, such as creation, sending, and completion.
- [List signature requests](https://docs.formabledocs.com/api-reference/signature-requests/list-signature-requests.md): Returns all signature requests for the authenticated client's organization, newest first. Optionally pass updatedSince to return only requests updated strictly after that instant (ISO-8601).
- [Create a template](https://docs.formabledocs.com/api-reference/templates/create-a-template.md): Upload a PDF or DOCX file to create a new template. The file must be under 40MB and be either a PDF, DOC, or DOCX file.
- [Create a template edit URL](https://docs.formabledocs.com/api-reference/templates/create-a-template-edit-url.md): Generates an edit URL for a template. The URL can be used to access the template editor interface, where you can place and configure fields. The client must be authorized to edit the template.
- [Authentication](https://docs.formabledocs.com/authentication.md): Authenticate requests with an OAuth 2.0 bearer token.
- [Core concepts](https://docs.formabledocs.com/concepts.md): The key objects and terms you'll work with in the Formable API.
- [E-signature workflow](https://docs.formabledocs.com/guides/e-signatures.md): Send a document for signature, prefill fields, and retrieve the signed result.
- [Redlining workflow](https://docs.formabledocs.com/guides/redlining.md): Run a turn-based contract negotiation between two parties.
- [Manage templates](https://docs.formabledocs.com/guides/templates.md): Upload documents and place fields to reuse across signature and redline requests.
- [Formable API](https://docs.formabledocs.com/index.md): Embed e-signatures and collaborative document redlining directly into your product.
- [Quickstart](https://docs.formabledocs.com/quickstart.md): Create your first signature request and get an embeddable signing URL.
- [Event catalog](https://docs.formabledocs.com/webhooks/events.md): Every webhook event type and its payload schema.
- [Webhooks overview](https://docs.formabledocs.com/webhooks/overview.md): Receive real-time notifications when documents are signed, viewed, or redlined.
- [Verifying signatures](https://docs.formabledocs.com/webhooks/verifying-signatures.md): Confirm that a webhook request genuinely came from Formable.

## OpenAPI Specs

- [openapi](https://docs.formabledocs.com/api-reference/openapi.json)