---
title: "Get category"
method: GET
path: "/categories/{id}"
tags: ["Categories"]
---

# Get category

`GET /categories/{id}`

Retrieve details for a category.

## Path parameters

- `id` string, required

## Response `200`

Success

- object
  - `success` true, required
  - `item` GenieCategory, required — A category classification result from Genie. This classification provides the base [NZFCC](https://nzfcc.org) category code for the transaction. Additionally, the `groups` attribute includes a mapping of the NZFCC category into broader (less-specific) category groups. Category grouping is based on mappings which are able to be customised per-client. The `personal_finance` mapping is included by default.
    - `_id` string, required — The [NZFCC](https://nzfcc.org) category code for the transaction
    - `name` string, required — The name of the NZFCC category for this transaction
    - `groups` object, required — A dictionary of category groups, keyed by category mapping name, for the NZFCC base category.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `429` — Rate Limiting
- `500` — Internal Server Error

---

[API](https://skmtc.dev/akahu/apis/akahu-enduring-api.md) · [All operations](https://skmtc.dev/akahu/apis/akahu-enduring-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/akahu/akahu-enduring-api/revisions/b2de9915920d/schema)