---
title: "Search demographic fields"
method: GET
path: "/v1/data/demographics/fields"
tags: ["Demographics"]
---

# Search demographic fields

`GET /v1/data/demographics/fields`

## Request

- Base URL: `https://api.mapulus.com`
- URL: `https://api.mapulus.com/v1/data/demographics/fields`
- Auth: HTTP bearer

Browse and search the demographic field catalog.

Use `topic` to filter by category, `search` for free-text matching.
The catalog contains 13,498 fields across 25 topics.

**Common workflows:**

1. **Discover what's available:** `GET /v1/data/demographics/fields?topic=income`
2. **Search by keyword:** `GET /v1/data/demographics/fields?search=median`
3. **Get field detail:** `GET /v1/data/demographics/fields/medians.age`
4. **Use in a query:** `GET /v1/data/demographics?boundary_id=sa2:117011325&fields=medians.age`
5. **Use derived percentages:** `GET /v1/data/demographics?lat=-33.87&lng=151.21&fields=derived.pct_indigenous,derived.pct_seniors_65_plus`

## Query parameters

- `topic` string, nullable: Filter by topic (e.g. `income`, `age`).
- `search` string, nullable: Search fields by name or label (e.g. `median`, `population`).
- `limit` integer: Maximum results to return.
- `offset` integer: Pagination offset.

## Response `200`

Matching fields from the catalog.

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mapulus/apis/mapulus-api.md) · [All operations](https://skmtc.dev/mapulus/apis/mapulus-api/llms.txt) · [OpenAPI document](https://skmtc.dev/mapulus/apis/mapulus-api/revisions/b99766fa053f?raw)