Endpoints
| Method | Endpoint | Description |
|---|---|---|
| GET | /transactions | List all transactions |
| POST | /transactions | Create new transaction |
| GET | /transactions/:id | Get transaction by ID |
| PUT | /transactions/:id | Update transaction |
| DELETE | /transactions/:id | Delete transaction |
List Transactions
GET /transactions
Authorization: Bearer <token>
| Parameter | Type | Description |
|---|---|---|
wallet_id | UUID | Filter by wallet |
category_id | UUID | Filter by category |
start_date | Date | Start of date range |
end_date | Date | End of date range |
[
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"wallet_id": "550e8400-e29b-41d4-a716-446655440001",
"category_id": "550e8400-e29b-41d4-a716-446655440002",
"amount": 25.50,
"type": "expense",
"description": "Lunch",
"date": "2024-01-15",
"created_at": "2024-01-15T12:00:00Z",
"updated_at": "2024-01-15T12:00:00Z"
}
]
Create Transaction
POST /transactions
Authorization: Bearer <token>
Content-Type: application/json
{
"wallet_id": "550e8400-e29b-41d4-a716-446655440001",
"category_id": "550e8400-e29b-41d4-a716-446655440002",
"amount": 50.00,
"type": "expense",
"description": "Grocery shopping",
"date": "2024-01-15"
}
{
"id": "550e8400-e29b-41d4-a716-446655440003",
"wallet_id": "550e8400-e29b-41d4-a716-446655440001",
"category_id": "550e8400-e29b-41d4-a716-446655440002",
"amount": 50.00,
"type": "expense",
"description": "Grocery shopping",
"date": "2024-01-15",
"created_at": "2024-01-15T12:30:00Z",
"updated_at": "2024-01-15T12:30:00Z"
}
Transaction Schema
| Field | Type | Required | Description |
|---|---|---|---|
id | UUID | Auto | Unique identifier |
wallet_id | UUID | Yes | Associated wallet |
category_id | UUID | No | Associated category |
amount | Decimal | Yes | Transaction amount (positive) |
type | Enum | Yes | income, expense, or transfer |
description | String | No | Transaction description |
date | Date | Yes | Transaction date |
created_at | DateTime | Auto | Creation timestamp |
updated_at | DateTime | Auto | Last update timestamp |