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

# Get category

`GET /categories/{id}`

## Request

- Base URL: `https://api.genie.akahu.io/v1`
- URL: `https://api.genie.akahu.io/v1/categories/{id}`
- Auth: HTTP bearer

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/genie-transaction-enrichment-api.md) - [All operations](https://skmtc.dev/akahu/apis/genie-transaction-enrichment-api/llms.txt) - [OpenAPI document](https://skmtc.dev/akahu/apis/genie-transaction-enrichment-api/revisions/b572302ad274?raw)