API
API overview and authentication
REST endpoints for Business and Enterprise accounts to translate text and read current word usage with API-key authentication.
The DeepReference API lets a server-side application translate text with the same engine, glossaries, and Translation Memory as the workspace. It currently exposes translation and usage endpoints and is available on Business and Enterprise plans.
API keys
Create a key in enterprise settings
Account admins create and manage API keys (they start with dr_) from the enterprise settings, alongside team members and shared assets.
Store it like a password
The key authenticates as your account and consumes your word allowance. Keep it in an environment variable or a secret manager, never in client-side code or a repository.
Manage the lifecycle
Keys can be renamed (so "CMS production" and "staging" stay distinguishable), temporarily disabled and re-enabled, or revoked permanently, all from the same screen. Disable first, revoke when you are sure.
Authentication
Send your key with every request, either as a Bearer token or in the X-API-Key header:
curl https://www.deepreference.com/api/v1/usage \ -H "Authorization: Bearer dr_your_key_here" curl https://www.deepreference.com/api/v1/usage \ -H "X-API-Key: dr_your_key_here"
How API usage is billed
Exactly like the app: you are charged for the visible words in the returned translation, never for prompts, instructions, or internal processing. API usage draws from the same monthly allowance as your workspace; check it any time with the usage endpoint.
Workspace assets also apply to API calls
API requests use the language assets and billing allowance attached to the account. A translation sent from a CMS or internal service can therefore use the same glossary rules and exact Translation Memory matches as a request made in the workspace.
Keep exploring
POST /v1/translate
Translate a piece of text with your account's settings and language assets. The core endpoint of the API.
GET /v1/usage
Read the used, limit, and remaining word counts for the current billing period.
Teams and enterprise
Set up members, permissions, word limits, shared language assets, review access, and API keys on Business and Enterprise plans.
Plans and billing
See the current plan limits, included workflow tools, word-counting rules, billing options, and capacity top-ups.