Legalesign GraphQL API
Legalesign offers two APIs for e-signature integration:
- REST API - Quick start, traditional format
- GraphQL API - Full power, more flexible
This guide focuses on GraphQL. You'll need JSON knowledge and basic web request experience.
Why Choose GraphQL?
REST is reliable, familiar, and here to stay. GraphQL gives you a different way to think about retrieving and shaping data. At Legalesign, GraphQL is the first-class API — every part of the platform is available through it.
| REST | GraphQL | |
|---|---|---|
| Endpoints | Multiple (/users, /contracts, etc.) | Single (/graphql) |
| Data fetching | Fixed per endpoint | Client-defined queries |
| Over/under-fetching | Common | Reduced |
| Versioning | Versioned (/v1/, /v2/) | Versionless — new fields don't break existing queries |
| Authentication | API key | SRP or API key subset |
GraphQL gives you complete access to Legalesign's features:
- Request only the data you need
- Single endpoint for everything
- Same power as the web app
TypeScript/JavaScript Developers
Consider the TS/JS SDK for common use cases, but learning GraphQL gives you full platform access. Compare SDK vs GraphQL.
Try GraphQL Now
Start with the GraphQL Explorer (requires active account).
The Explorer lets you:
- Test queries and mutations
- Browse the complete schema
- Debug before coding
If you're logged into Legalesign, authentication is automatic.
For a minimal first working example, go to the Quickstart.
Find ready-made queries and mutations by inspecting network requests in the Legalesign web app console.
Programmatic Access
GraphQL supports two authentication modes:
| Mode | Coverage | Header | Best for |
|---|---|---|---|
| SRP | Full GraphQL schema | Authorization: Bearer <access-token> | Complete integrations |
| API Key | Supported subset only | Authorization: Bearer <api-key> | Server-side automation and common send/read flows |
For SRP authentication, contact Legalesign support to obtain the credentials and details for your integration.
For API-key authentication, create a GraphQL-enabled key in the Developer Portal and check the API-key GraphQL reference for supported queries and mutations.
See the authentication guide for more detail.
Using an AI Coding Tool?
If you use Cursor, Claude, Windsurf, or another AI assistant, connect it to the Legalesign docs server for context-aware help while you code. See Connect Your AI Tool.
Next Steps
- Start with the Quickstart
- Add real-time events with Real-Time Websocket Quickstart
- Explore the schema in the GraphQL Explorer
- Choose SRP or API-key authentication for programmatic access
- Follow a tutorial: Node.js · C#
- Connect your AI tool for context-aware coding assistance
GraphQL gives you the same power as the Legalesign web app — if you can do it there, you can do it with the API.