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

> 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-jade-io-api-ac3085cd/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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.paywithlocus.com/api/wrapped/parse-jade-io-api-ac3085cd/get_case \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-jade-io-api-ac3085cd/get_recent_cases \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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.paywithlocus.com/api/wrapped/parse-jade-io-api-ac3085cd/lookup_citation \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"court":"<string>","number":"<string>","year":"<string>"}'
```