# Dermnetnz — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.

> Search a comprehensive database of dermatological conditions to get detailed information including symptoms, causes, treatments, and extensive photo galleries for diagnosis and reference. Explore hair and scalp conditions or any other skin concern with structured medical descriptions and visual examples.

**Category:** Healthcare | **Website:** [dermnetnz.org/](https://dermnetnz.org/) | **Docs:** [parse.bot/marketplace/e19bc0a4-11ad-4135-bb7f-6ff7ce35f9b7/dermnetnz-org-api](https://parse.bot/marketplace/e19bc0a4-11ad-4135-bb7f-6ff7ce35f9b7/dermnetnz-org-api)

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

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/credits/dermnetnz/`
**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

### Get condition details

Retrieve comprehensive dermatological information for a specific condition including descriptions, symptoms, causes, diagnosis, treatment options, prevention, and outcome prognosis. Also fetches all associated images from the condition's image collection. Content is extracted from DermNet NZ topic pages and structured into named detail fields plus a raw section list.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The URL slug of the condition (e.g. 'alopecia-areata', 'acne-vulgaris'). Obtainable from list_conditions results. |

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

### Get image library

Search for images across the entire DermNet database by keyword. Matches the query against image titles and captions. Returns up to 100 matching images with metadata including file size and sensitivity classification.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search keyword for finding images by title or caption. |

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

### List conditions

Search for dermatological conditions on DermNet NZ. When a query is provided, filters conditions by matching the query against titles and synonyms. When no query is provided, returns a default set of hair and scalp conditions. Results are sorted alphabetically by title.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | No | Optional search keyword to filter conditions by title or synonym. Omitting the query returns a default set of hair and scalp conditions. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/dermnetnz/list-conditions \
  -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://beta.paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://beta.paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://beta.paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://beta.paywithlocus.com/agent/index.md): every Locus agent page.