# Formality API

**Canonical:** https://apis.io/apis/formality/formality-api/  
**Provider:** Formality — https://apis.io/providers/formality/  
**Base URL:** https://app.eu1.formality.com/api/v1/{workspaceId}  
**Documentation:** https://help.formality.com/integrations/api

Formality API is published by [Formality](https://apis.io/providers/formality/) on the [APIs.io](https://apis.io/) network. Tagged areas include Contract Management, Documents, Legal, and Agreements. The published artifact set on APIs.io includes an API reference and authentication docs.

The Formality REST API exposes the workspace contract repository so external tools and AI agents can retrieve documents and the AI-extracted metadata layer. Every path is namespaced to a workspace — /api/v1/{workspaceId}/ — and the documented resources cover agreements and agreement fields, with the help centre describing coverage of agreements, counterparties and related entities. Access uses a two-step bearer flow: an administrator mints a long-lived personal Refresh Token in Personal Settings > Formality API, then exchanges it at GET /api/v1/token for a 5-minute access token used as Authorization: Bearer on subsequent calls. A Swagger UI is published at /-/api-doc-swagger but is reachable only after authenticating.

## Machine-readable artifacts (7)

- **APIReference** — https://help.formality.com/integrations/api
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/formality/refs/heads/main/authentication/formality-authentication.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/formality/refs/heads/main/errors/formality-problem-types.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/formality/refs/heads/main/conventions/formality-conventions.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/formality/refs/heads/main/data-model/formality-data-model.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/formality/refs/heads/main/asyncapi/formality-webhooks.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/formality/refs/heads/main/apis.yml

## Tags

Contract Management, Documents, Legal, Agreements

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/formality/formality-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/formality/.