# Physionet — 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.

> Search and access biomedical research datasets from PhysioNet, including detailed dataset information, file listings, and content retrieval for medical data analysis. Stay updated with the latest news and manage your account through secure login.

**Category:** Healthcare | **Website:** [physionet.org/](https://physionet.org/) | **Docs:** [parse.bot/marketplace/3cdc01af-c55f-4da0-b516-0019eeeef856/physionet-org-api](https://parse.bot/marketplace/3cdc01af-c55f-4da0-b516-0019eeeef856/physionet-org-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/physionet/`
**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 dataset detail

Retrieve full metadata for a specific dataset version including title, DOI, abstract, citation, authors, and publication info. Returns input_not_found if the slug/version combination does not exist on PhysioNet.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | Dataset slug identifier (e.g. 'mitdb', 'chbmit', 'siena-scalp-eeg') |
| `version` | string | Yes | Dataset version string (e.g. '1.0.0') |

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

### Get file content

Retrieve the text content of a specific metadata or text-based file from an Open Access dataset. Returns an upstream error for binary files or credentialed datasets. Content is capped at 100,000 characters.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `filepath` | string | Yes | Path to the file within the dataset (e.g. 'RECORDS', 'subject-info.csv') |
| `slug` | string | Yes | Dataset slug identifier (e.g. 'mitdb') |
| `version` | string | Yes | Dataset version string (e.g. '1.0.0') |

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

### List dataset files

Browse the file and directory index of a dataset version. Only works for Open Access datasets; credentialed/restricted datasets require authentication and will return an upstream error. Returns file and directory entries with name, size, date, and URL.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `path` | string | No | Subdirectory path within the dataset to list |
| `slug` | string | Yes | Dataset slug identifier (e.g. 'mitdb') |
| `version` | string | Yes | Dataset version string (e.g. '1.0.0') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/physionet/list-dataset-files \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"path":"<string>","slug":"<string>","version":"<string>"}'
```

### List news

Retrieve latest news and announcements from PhysioNet. Returns all news items currently displayed on the news page, ordered from newest to oldest.

**Estimated cost:** Metered

_No parameters required._

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

### Search resources

Search for PhysioNet resources (datasets, software, challenges, models) by keyword. Returns paginated results with metadata about each matching resource including title, slug, version, authors, description, tags, and access level. Paginates via integer page number. Server-side filtering is limited to query, type, and sort order.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `orderby` | string | No | Sort order for results |
| `page` | integer | No | Page number for pagination |
| `query` | string | No | Search keyword or topic |
| `types` | string | No | JSON array of resource type integers to filter: 0=Data, 1=Software, 2=Challenge, 3=Model. Omitting returns all types. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/physionet/search-resources \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"orderby":"<string>","page":"<integer>","query":"<string>","types":"<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.