Penny Docs
Categories

List Categories

GET
/v1/households/{household_id}/categories

Lists the household's active categories and all category groups in a single response.

Match each category's group ID to the returned groups to build a grouped category picker. Ungrouped categories have a null group ID. The response is not paginated.

Authorization

PersonalApiToken
AuthorizationBearer <token>

Use your personal API token (penny_pat_…) as the bearer credential. Enter the token only; the client adds the Bearer prefix. Read-only tokens permit read requests. Read/write tokens remain limited by your current household membership and role. See https://penny.finance/docs/api#authentication for setup.

In: header

Path Parameters

household_id*Household Id

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/households/string/categories"
{  "categories": [    {      "id": "Ct5nR8wY1jFu",      "name": "Coffee & Dining",      "emoji": "☕️",      "category_type": "income",      "group_id": "Cg2mV7pL4zXe"    }  ],  "groups": [    {      "id": "Cg2mV7pL4zXe",      "name": "Everyday Expenses",      "group_type": "income"    }  ]}