Getting Started
Overview
Pasona Finance Tracker API is a JSON-based REST API for the Pasona Finance Tracker. All requests are made over HTTPS and authenticated using a Sanctum bearer token.
Base URL
Every endpoint in this documentation is relative to the following base URL:
BASE URL
/apiConventions
- All request bodies and responses are JSON.
- Timestamps follow ISO 8601 (e.g.
2026-06-03T12:00:00Z). - Monetary amounts are returned as strings with two decimals on stored values and as numbers on calculated values like
balanceandmonthly_summary. - All resource IDs are integers.
Required headers
Every request must include the following headers:
| Header | Value | Description |
|---|---|---|
Accept |
application/json |
Tells the API to return a JSON response. |
Content-Type |
application/json |
Required when sending a request body. |
Authorization |
Bearer {token} |
Your API key. Required for all protected endpoints. |
Environments
The API runs alongside the Laravel backend. In development, the same base URL is used for both local and production traffic — just point your client at the backend's host.
| Environment | Base URL | Notes |
|---|---|---|
| Local | http://localhost:8000/api |
Default Laravel php artisan serve port. |
| Live | /api |
Production. Configure with the API_BASE_URL env variable. |