Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /categories | List all categories |
| POST | /categories | Create new category |
| GET | /categories/:id | Get category by ID |
| PUT | /categories/:id | Update category |
| DELETE | /categories/:id | Delete category |
List Categories
GET /categories
Authorization: Bearer <token>
[
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Food & Dining",
"type": "expense",
"color": 4294942720,
"icon": "restaurant",
"created_at": "2024-01-15T10:30:00Z",
"updated_at": "2024-01-15T10:30:00Z"
}
]
Create Category
POST /categories
Authorization: Bearer <token>
Content-Type: application/json
{
"name": "Salary",
"type": "income",
"color": 4283215696,
"icon": "attach_money"
}
{
"id": "550e8400-e29b-41d4-a716-446655440001",
"name": "Salary",
"type": "income",
"color": 4283215696,
"icon": "attach_money",
"created_at": "2024-01-15T12:00:00Z",
"updated_at": "2024-01-15T12:00:00Z"
}
Category Schema
| Field | Type | Required | Description |
|---|---|---|---|
id | UUID | Auto | Unique identifier |
name | String | Yes | Category name |
type | Enum | Yes | income or expense |
color | Integer | No | ARGB color value |
icon | String | No | Icon identifier |
created_at | DateTime | Auto | Creation timestamp |
updated_at | DateTime | Auto | Last update timestamp |