# Nomisweb — 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 official UK labour market statistics and population data from Nomis, including resident population figures, qualification levels, and detailed datasets. Search and retrieve the specific labour and demographic information you need for analysis and reporting.

**Category:** Government & Public Data | **Website:** [nomisweb.co.uk/](https://nomisweb.co.uk/) | **Docs:** [parse.bot/marketplace/9da28ef2-99a6-4c95-b506-ee94a5d4ed84/nomisweb-co-uk-api](https://parse.bot/marketplace/9da28ef2-99a6-4c95-b506-ee94a5d4ed84/nomisweb-co-uk-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-nomisweb-co-uk-api-9da28ef2/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_qualifications

Retrieve RQF (Regulated Qualifications Framework) qualification level counts from the Annual Population Survey (dataset NM_17_1) for people aged 16-64 in a specified local authority area and time period. Returns counts by qualification level; some values may be suppressed as statistically unreliable.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area_name` | string | No | Name of the local authority area (e.g. Camden, Westminster, Islington, Hackney, Tower Hamlets). |
| `time_period` | string | No | Time period code in format YYYY-MM where MM indicates the end month of the survey period (e.g. 2023-12 for Jan 2023-Dec 2023, 2022-12 for Jan 2022-Dec 2022). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nomisweb-co-uk-api-9da28ef2/get_qualifications \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_name":"<string>","time_period":"<string>"}'
```

### get_resident_population

Retrieve resident population estimates from ONS dataset NM_31_1 for a given local authority area and year. Returns a single observation with population count, ONS geography code, and data quality status. The underlying dataset covers mid-year population estimates for England and Wales local authorities.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area_name` | string | No | Name of the local authority area (e.g. Camden, Westminster, Islington, Hackney, Tower Hamlets). |
| `year` | string | No | Year for population estimates (e.g. 2023, 2022, 2021). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nomisweb-co-uk-api-9da28ef2/get_resident_population \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_name":"<string>","year":"<string>"}'
```

### list_datasets

List all available datasets in the Nomis catalogue with their identifiers and human-readable names. Returns the full set of datasets accessible through the Nomis API, covering labour market statistics, population estimates, census data, and more.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-nomisweb-co-uk-api-9da28ef2/list_datasets \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```