Categories

All endpoints are POST with a JSON body, authenticated with your secret key (Authentication). Errors use the standard envelope; money is in major units with an iso_currency_code; dates are YYYY-MM-DD strings.

Get categories

Returns the full, static category taxonomy used everywhere: transaction category / category_detailed, recurring streams, and the AI categorizer. The taxonomy is versioned with the API — treat it as an enum, not free text. The body is an empty JSON object.

curl https://api.feelconnect.dev/v1/categories/get \
  -H "Authorization: Bearer $FEELCONNECT_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'

{
  "categories": [
    {
      "primary": "Income",
      "detailed": [
        "Salary",
        "Freelance",
        "Interest",
        "Dividends",
        "Refund",
        "Bonus",
        "Other Income"
      ]
    },
    {
      "primary": "Food & Drink",
      "detailed": [
        "Restaurants",
        "Fast Food",
        "Coffee Shops",
        "Bars & Nightlife",
        "Delivery",
        "Bakeries & Desserts"
      ]
    }
  ]
}

The taxonomy

14 primary categories; every transaction resolves to exactly one (primary, detailed) pair.