# Nzsl — 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 and explore over 5000 New Zealand Sign Language signs with English and Māori translations, video demonstrations, and example sentences. Access detailed sign information, alphabet and number references, classifier pages, and get a sign of the day to expand your NZSL vocabulary.

**Category:** Education | **Website:** [nzsl.nz/](https://nzsl.nz/) | **Docs:** [parse.bot/marketplace/2cef0dd3-212e-4356-8484-758f07b0743b/nzsl-nz-api](https://parse.bot/marketplace/2cef0dd3-212e-4356-8484-758f07b0743b/nzsl-nz-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/nzsl/`
**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 all signs

Retrieve all signs paginated in alphabetical order. Equivalent to an empty search with no filters applied. Returns ~25 signs per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

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

### Get alphabet page

Retrieve the NZSL fingerspelling alphabet reference page content, including letter images and demonstration videos. Contains 29 alphabet items (some letters have open/closed variants) and multiple demonstration video URLs.

**Estimated cost:** Metered

_No parameters required._

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

### Get classifiers page

Retrieve the NZSL classifiers reference page content, organized by classifier type categories. Each category contains items with a label and image_url showing the classifier handshape.

**Estimated cost:** Metered

_No parameters required._

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

### Get numbers page

Retrieve the NZSL numbers reference page content, organized by category (Cardinal Numbers, Ordinal Numbers, Age). Each category contains items with a label, sign_id, and image_url.

**Estimated cost:** Metered

_No parameters required._

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

### Get search autocomplete

Get autocomplete suggestions for a search term. Returns a list of matching sign glosses as strings. Works best with complete words or common terms.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `term` | string | Yes | Search term for autocomplete suggestions (e.g. 'cat', 'water', 'house'). |

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

### Get sign detail

Retrieve full detail for a specific sign by its numeric ID, including videos, drawings, examples, handshapes, and locations. The sign_id is obtained from search_signs or get_all_signs results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `sign_id` | string | Yes | Numeric sign ID (e.g. '1301', '5243'). Obtained from search_signs results. |

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

### Get sign of the day

Retrieve the Sign of the Day featured on the homepage. Changes daily. Returns the sign name, ID, video URL, and drawing URL.

**Estimated cost:** Metered

_No parameters required._

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

### List topics

Get the full list of topic categories available for filtering signs. Returns all 45 topic tags. The tag values can be passed directly to the search_signs topic parameter.

**Estimated cost:** Metered

_No parameters required._

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

### Search signs

Search for signs by keyword (English or Māori) with optional filters. Returns paginated results. When no query or filters are provided, returns all signs ordered alphabetically. Supports filtering by topic, handshape, body location, location group, and usage. Each page returns up to ~25 results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `handshape` | string | No | Handshape ID filter (e.g. '1.1.1'). |
| `location` | string | No | Body location ID filter. |
| `location_group` | string | No | Location group ID filter. |
| `page` | integer | No | Page number for pagination. |
| `query` | string | No | Search keyword in English or Māori (e.g. 'hello', 'water'). |
| `topic` | string | No | Topic category filter. Use the tag value from list_topics (e.g. 'Animals', 'Actions and activities'). |
| `usage` | string | No | Usage filter (e.g. 'archaic', 'informal'). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/nzsl/search-signs \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"handshape":"<string>","location":"<string>","location_group":"<string>","page":"<integer>","query":"<string>","topic":"<string>","usage":"<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.