Quick Start

Get up and running with the Ogarni.AI API in three steps.

1. Create an API token

1. Download the Ogarni.AI mobile app (App Store | Google Play)
2. Log in to the app
3. Go to Settings > API Tokens
4. Click Create token, choose the read scope, and give it a name
5. Copy the token immediately — it is shown only once

Your token will look like this: oai_... (the oai_ prefix followed by an encoded payload).

2. Make your first request

Use the token to call any read-only endpoint. Here is a simple curl command that fetches your latest weekly spending summary:

curl -X GET "https://api.ogarni.ai/api/weekly-summaries/latest" \
  -H "X-API-Key: oai_your_token_here" \
  -H "Accept: application/json"

3. See the results

A successful response returns JSON with your weekly summary:

{
  "userId": "...",
  "periodStart": "2025-01-06T00:00:00Z",
  "periodEnd": "2025-01-12T23:59:59Z",
  "summary": "This week you spent 320.50 PLN across 8 transactions...",
  "totalAmount": 320.50,
  "categoryTotals": [
    { "category": "Groceries", "totalAmount": 180.00 },
    { "category": "Transport", "totalAmount": 45.50 }
  ],
  "dailySummaries": [ ... ]
}

Next steps

• API tokens — Learn about scopes, rotation, and security.
• Endpoints — Explore all 20+ available endpoints.
• Code examples — See examples in Python and JavaScript.
• MCP server — Connect Claude and other LLMs to your data.