# Nursys — 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 nurse licensure records across multiple state boards and verify nursing credentials in real-time through Nursys QuickConfirm. Get detailed information about participating jurisdictions and their specific licensure requirements.

**Category:** Healthcare | **Website:** [nursys.com/](https://nursys.com/) | **Docs:** [parse.bot/marketplace/663b242b-ca33-4f7a-936e-e63e39421ee7/nursys-com-api](https://parse.bot/marketplace/663b242b-ca33-4f7a-936e-e63e39421ee7/nursys-com-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/nursys/`
**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 jurisdictions

Retrieve the list of all participating boards of nursing, their participation levels, last data submission dates, and numeric state IDs used for search queries. Returns all 58 US states, territories, and jurisdictions that participate in Nursys QuickConfirm License Verification. No parameters required.

**Estimated cost:** Metered

_No parameters required._

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

### Search nurse

Search for nurse licensure records by name, license number, or NCSBN ID. Name search requires last_name, first_name, license_type, and state. License number search requires license_number and state. NCSBN ID search requires only the ncsbn_id. Returns a list of matching individuals, each with their associated license records across jurisdictions. Requires solving a reCAPTCHA v2 security verification.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `first_name` | string | No | First name of the nurse. Required for name search. |
| `last_name` | string | No | Last name of the nurse. Required for name search. Partial matches accepted. |
| `license_number` | string | No | License number for license number search. Requires state to be specified. |
| `license_type` | string | No | Numeric ID of the license type. Required for name search. Values: 2 (PN), 3 (RN), 8 (APRN-CNP), 6 (APRN-CRNA), 5 (APRN-CNM), 7 (APRN-CNS). |
| `ncsbn_id` | string | No | NCSBN Public ID for ID-based search. When provided, other fields are not required. |
| `state` | string | No | Numeric ID of the jurisdiction/state. Required for name search and license number search. Examples: 78 (Alabama), 94 (Alaska), 96 (Arizona), 12 (California-RN). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nursys/search-nurse \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"first_name":"<string>","last_name":"<string>","license_number":"<string>","license_type":"<string>","ncsbn_id":"<string>","state":"<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.