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

> Access Australian legal cases from JADE, including recent High Court of Australia decisions and full case content retrieved by article ID or medium neutral citation. Look up specific cases quickly using their standardized citation format to stay informed on the latest Australian legal precedents.

**Category:** Government & Public Data | **Website:** [jade.io/](https://jade.io/) | **Docs:** [parse.bot/marketplace/ac3085cd-2eba-45aa-ac89-3d65c816696d/jade-io-api](https://parse.bot/marketplace/ac3085cd-2eba-45aa-ac89-3d65c816696d/jade-io-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/jade/`
**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 case

Retrieves the full content of a legal case by its JADE article ID. Returns metadata (title, citation, court, catchwords) and the complete judgment text. Article IDs can be obtained from the get_recent_cases endpoint or from lookup_citation. Makes two requests: one for the case text and one for the title metadata.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `article_id` | string | Yes | Numeric JADE article ID (e.g. 400000, 1227673). Obtainable from get_recent_cases results or lookup_citation results. |

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

### Get recent cases

Retrieves a list of recent High Court of Australia (HCA) cases from the JADE Express page. Returns case names, citations, decision dates, and judges. Typically returns approximately 49 of the most recent HCA decisions. No pagination — entire list returned in one call.

**Estimated cost:** Metered

_No parameters required._

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

### Lookup citation

Look up an Australian legal case by its medium neutral citation components (year, court code, and case number). Returns the case name, full citation, the numeric JADE article ID, and the canonical jade.io article URL. The article_id can be passed directly to the get_case endpoint. Court codes include HCA (High Court), FCA (Federal Court), FCAFC (Full Federal Court), VSC (Supreme Court of Victoria), VSCA (Court of Appeal Victoria), VCC (County Court Victoria), VCAT (Victorian Civil and Administrative Tribunal), NSWSC, NSWCA, QCA, QSC, SASC, WASC.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `court` | string | Yes | Court abbreviation code (e.g. VSC, VSCA, VCC, VCAT, HCA, FCA, FCAFC, NSWSC, NSWCA, QCA, QSC, SASC, WASC). |
| `number` | string | Yes | Case number within that court and year (e.g. 1, 100, 945). |
| `year` | string | Yes | 4-digit year of the decision (e.g. 2020, 2023). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/credits/jade/lookup-citation \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"court":"<string>","number":"<string>","year":"<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.