Skip to content
Last updated

Retrieve a specific invoice by ID. Non-staff users can only access their organization's invoices.

GEThttps://api.aitronos.com/v1/invoices/{invoice_id}

Path Parameters

invoice_id string required

Invoice ID (format: inv_<uuid>).

Returns

Returns the complete invoice object including all line items, tax calculations, and metadata.

Bash
curl "https://api.aitronos.com/v1/invoices/inv_123e4567e89b12d3a456426614174000" \
  -H "X-API-Key: $FREDDY_API_KEY"

Response:

{
  "id": "inv_123e4567e89b12d3a456426614174000",
  "invoice_number": "INV-2024-12-AIT-001",
  "organization_id": "org_123e4567e89b12d3a456426614174000",
  "organization_name": "Aitronos AG",
  "billing_period_start": "2024-12-01T00:00:00Z",
  "billing_period_end": "2025-01-01T00:00:00Z",
  "issue_date": "2024-12-31T23:59:59Z",
  "due_date": "2025-01-30T23:59:59Z",
  "payment_date": null,
  "currency": "CHF",
  "exchange_rate": 1.0,
  "subtotal": 1250.50,
  "tax_rate": 0.081,
  "tax_amount": 101.29,
  "total_amount": 1351.79,
  "status": "issued",
  "items": [
    {
      "id": "invitem_123e4567e89b12d3a456426614174000",
      "description": "GPT-4 Turbo - Input Tokens",
      "model_name": "gpt-4-turbo",
      "provider": "openai",
      "quantity": 1250.5,
      "unit": "1K tokens",
      "unit_price": 0.01,
      "amount": 12.51,
      "input_tokens": 1250500,
      "output_tokens": null,
      "total_requests": 1523
    }
  ],
  "created_at": "2024-12-31T23:59:59Z",
  "updated_at": "2024-12-31T23:59:59Z"
}