# Openmd — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Look up medical terms, abbreviations, and word parts to understand healthcare terminology, browse health resources by category, and access research guides on various medical topics. Find dangerous drug abbreviations and prescription shorthand to stay informed about medication safety.

**Category:** Healthcare | **Website:** [openmd.com/](https://openmd.com/) | **Docs:** [parse.bot/marketplace/0280bd3d-25b7-46b9-9366-368f3236f60c/openmd-com-api](https://parse.bot/marketplace/0280bd3d-25b7-46b9-9366-368f3236f60c/openmd-com-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/openmd/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Browse dictionary by letter

List medical dictionary terms alphabetically by letter. Returns all terms starting with the specified letter with links to their definition pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | Single letter A-Z to browse terms. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/openmd/browse-dictionary-by-letter \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>"}'
```

### Get abbreviations by letter

Retrieve medical abbreviations starting with a specific letter. Returns abbreviation-meaning pairs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | Single letter A-Z to filter abbreviations. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/openmd/get-abbreviations-by-letter \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>"}'
```

### Get dangerous abbreviations

Retrieve the specialized guide for dangerous medical abbreviations that are prone to causing prescription errors. Returns structured content with tables identifying risky abbreviations.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/openmd/get-dangerous-abbreviations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get dictionary term

Retrieve full definitions and metadata for a specific medical term. Returns definitions from multiple medical sources, pronunciation, category, etymology, images, and related videos when available. Coverage is strongest for anatomy terms; some disease terms may return fewer definitions.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `term` | string | Yes | Medical term to look up (e.g. 'heart', 'lung', 'diabetes'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/openmd/get-dictionary-term \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"term":"<string>"}'
```

### Get directory categories

List all categories in the health site directory. Returns category names, URLs, and slugs that can be used with get_directory_category.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/openmd/get-directory-categories \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get directory category

Retrieve sites listed under a specific directory category. Use a slug from get_directory_categories results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category_slug` | string | Yes | Category slug from get_directory_categories (e.g. 'cardiology', 'neurology', 'dermatology'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/openmd/get-directory-category \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"category_slug":"<string>"}'
```

### Get prescription abbreviations

Retrieve the specialized guide for common prescription abbreviations. Returns structured content including tables of abbreviation-meaning pairs used in medical prescriptions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/openmd/get-prescription-abbreviations \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Get research guide

Retrieve the structured content of a specific research guide. Use a slug from list_research_guides results. Returns title and content blocks (text, headings, lists, tables).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `guide_slug` | string | Yes | Guide slug from list_research_guides (e.g. 'medical-terminology', 'blood-types', 'levels-of-evidence'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/openmd/get-research-guide \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"guide_slug":"<string>"}'
```

### Get word parts by letter

Retrieve medical word parts (roots, prefixes, suffixes) starting with a specific letter. Returns word part and meaning pairs.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `letter` | string | No | Single letter A-Z to filter word parts. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/openmd/get-word-parts-by-letter \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"letter":"<string>"}'
```

### List research guides

List available health research guides. Returns titles, URLs, and slugs that can be used with get_research_guide.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/openmd/list-research-guides \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### Search dictionary

Search for medical terms in the OpenMD dictionary. Returns a direct match with full details if the term exists, or a list of matching term links otherwise.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Medical term or phrase to search for (e.g. 'heart', 'lung'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/openmd/search-dictionary \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.