Getting Started
Getting started
Base URLs, credentials, and your first request to the Dorascribe API.
The Dorascribe API lets you embed the ambient AI scribe in your own product: authenticate, launch the widget for a patient encounter, and receive a structured, coded note back through a callback.
Base URLs
The API is versioned under /api/v1. Use the sandbox while you build and switch
to production when you go live.
| Environment | Base URL |
|---|---|
| Production | https://api.dorascribe.ai/api/v1 |
| Sandbox | https://dev-api.dorascribe.ai/api/v1 |
What you need
- An organization API key. Generate one from your Dorascribe dashboard under organization settings. It identifies your organization on every request and is sent as a header — never in the request body.
- A billing model. Your organization uses either Prepaid Credits or Pay-as-You-Use. This determines which endpoints are available and how access tokens work — see Billing models.
Your first request
Check that your key works by listing the note templates available to your organization:
Shell
curl https://api.dorascribe.ai/api/v1/widget/all-templates \
-H "X-API-Key: org_your_api_key_here"
A 200 response with a list of templates means you're authenticated and ready
to go.
Next steps
- Authentication — the three credential types and where each is used.
- Widget integration — the full init → record → callback flow.
- API Reference — every endpoint with request and response schemas.