Quick Start

1. Get Your API Key

Sign up for free → or log in → to the Scribeberry Console. Once you've created a project, go to Settings → API Keys to generate a sandbox key (starts with sk_test_).

ℹ️ Info: Sandbox keys are free for development and testing. They work against our sandbox environment with no billing. No credit card required.

2. Install the SDK

npm install @scribeberry/sdk

3. Initialize the Client

import { Scribeberry } from '@scribeberry/sdk';
 
const sb = new Scribeberry({
  apiKey: 'sk_test_your_key_here',
  baseUrl: 'https://sandbox.api.scribeberry.com', // omit for production
});

4. List Available Templates

Templates define the structure of generated notes (SOAP notes, H&P, progress notes, etc.).

const { items: templates } = await sb.templates.list();
 
for (const template of templates) {
  console.log(`${template.name} (${template.documentType})`);
}

5. Generate Your First Note

const result = await sb.notes.generate({
  templateId: templates[0].id,
  conversationText: `
    Doctor: Good morning. What brings you in today?
    Patient: I've been having headaches for the past week.
    They're mostly in the front, around my forehead.
    Doctor: How would you rate the pain, one to ten?
    Patient: About a six. Tylenol helps a little.
    Doctor: Any nausea, vision changes, or fever?
    Patient: No, none of that.
    Doctor: Let's do a neurological exam and check your vitals.
    Everything looks normal. I'd recommend starting with
    ibuprofen 400mg every 8 hours and keeping a headache diary.
    Follow up in two weeks if it doesn't improve.
  `,
});
 
console.log(result.note.markdown);
// # Chief Complaint
// Headaches for one week, frontal location...
//
// # History of Present Illness
// ...

6. What's Next?

You just generated a structured clinical note from raw conversation text. Here's what to explore next:

Guide	Description
Authentication	API keys, temporary tokens, and security best practices
Templates	Create custom templates for your specialty
Realtime Transcription	Stream live audio for instant transcription
Error Handling	Handle errors gracefully in production

⚠️ Warning: Never expose your API key in client-side code. For browser-side realtime transcription, use temporary tokens instead.