Penny Docs
Categories

Get Category

GET
/v1/households/{household_id}/categories/{category_id}

Retrieves an active household category, including its emoji, type, and group assignment.

Returns category_not_found if the category is deleted or does not belong to this household.

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
category_id*Category Id

Response Body

application/json

application/json

application/json

application/json

application/json

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

Create Category POST

Creates a household category for classifying transactions as income, expense, or transfer. The name and emoji must each be unique among active household…

Delete Category DELETE

Deletes a category and makes its associated transactions uncategorized, including transactions on deleted accounts. The transactions themselves are…