> ## Documentation Index
> Fetch the complete documentation index at: https://docs.formabledocs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> REST endpoints for templates, signature requests, and related workflows.

The Formable API is organized around **templates** and **signature requests** for e-signing, with optional **redline request** endpoints for contract negotiation. It's a REST API with predictable, resource-oriented URLs, JSON request and response bodies, and standard HTTP status codes.

<Card title="Try it live" icon="play" href="/api-reference/endpoint/create-signature-request" horizontal>
  Every endpoint page includes a playground. Add your bearer token and send real requests from the docs.
</Card>

## Base URL

All endpoints are served under `/v1`.

```text theme={null}
https://api.formabledocs.com/v1
```

## Authentication

Every endpoint except the health check requires a Bearer token in the `Authorization` header. Create an API key in [Settings](https://app.formabledocs.com/settings), then pass it on each request. See [Authentication](/authentication) for details.

Prefer a typed client? Use an [official SDK](/sdks/overview) for Node.js, Python, PHP, Java, Go, Ruby, or .NET.

```bash theme={null}
Authorization: Bearer fmbl_YOUR_API_KEY
```

## Response format

Successful responses return JSON with a `200` status. Errors return a JSON object with a single `error` string:

```json theme={null}
{
  "error": "templateId is required"
}
```

## Status codes

| Code | Meaning |
| - | - |
| `200` | Success. |
| `400` | Bad request — missing or invalid parameters. |
| `401` | Unauthorized — missing or invalid bearer token. |
| `403` | Forbidden — the token is valid but not authorized for this resource. |
| `404` | Not found — the referenced resource doesn't exist. |
| `409` | Conflict — the resource isn't in a valid state (for example, signing an already-completed document). |
| `413` | Payload too large — the uploaded file exceeds 40MB. |
| `500` | Internal server error. |

## Resources

<CardGroup cols={2}>
  <Card title="Templates" icon="file-lines" href="/api-reference/endpoint/create-template">
    Upload documents and generate editor URLs.
  </Card>

  <Card title="Signature Requests" icon="signature" href="/api-reference/endpoint/create-signature-request">
    Send documents for e-signature and retrieve signed results.
  </Card>

  <Card title="Redlining" icon="pen-line" href="/api-reference/endpoint/create-redline-request">
    Create and manage collaborative redline negotiations.
  </Card>

  <Card title="Billing" icon="receipt" href="/api-reference/endpoint/get-billing">
    Retrieve usage information.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.