1. Account and API key - Tavrn Enterprise API

Access is per organization. Once your organization is onboarded, an organization admin signs in to the Tavrn Platform and creates API keys there. If your organization is not on Tavrn yet, book a demo.

Create an API key

In the Tavrn Platform, open API in the left menu (platform.tavrn.ai/dashboard/api).
Click Create API Key and name it after the system that will use it.
Select the permission scopes the integration needs (table below).
Copy the key. It is shown once; store it in your secrets manager.

Keys look like tavrn_sk_live_… and are shown only at creation. If a key is lost or leaked, create a new one and revoke the old one in the dashboard.

Scopes for a retrieval integration

Scope	Needed for
`retrievals:write`	Creating, cancelling and answering retrieval requests
`retrievals:read`	Reading request status, documents and costs
`cases:write`	Creating the case inline on the first request
`requestors:read`	Listing your firm profiles
`requestors:write`	Creating or updating a firm profile and uploading its documents
`webhooks:write`	Registering the endpoint that receives retrieval events

Add documents:read and documents:write later if you keep your own case documents in Tavrn. The full list is in Authentication.

Make the first call

curl https://enterprise.tavrn.ai/v2/requestors \
  -H "Authorization: Bearer $TAVRN_API_KEY"

A 200 with a results array (your organization’s default profile is in it) confirms the key works. A 401 means the key is wrong or revoked; a 403 means the key lacks the scope. See Errors for the response shape.

Next: set up your firm profile

Firm name, letter of representation, invoice approval limit and affidavits.