Tamio

Retrieve an invoice

GET https://api.tamio.com/v2/invoices/retrieve/{uuid}

Retrieves a single invoice by its UUID with full details including customer information, products, payment status, and fulfillment data.

Path Parameters

uuid string*

UUID of the invoice to retrieve

Responses

200 Invoice retrieved successfully

Invoice retrieved successfully

status integer
invoice Invoice
400 Validation or business-logic error.
401 Missing or invalid API key
/invoices/retrieve/{uuid}
1const response = await fetch("https://api.tamio.com/v2/invoices/retrieve/{uuid}", {
2 headers: {
3 "Authorization": "Bearer YOUR_API_KEY",
4 "Accept": "application/json"
5 }
6});
7const data = await response.json();
Responses
{
  "status": 200,
  "invoice": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "object": "invoice",
    "currency": "EUR",
    "paid": true,
    "processing_payment": false,
    "prefix": "INV-",
    "number": 1001,
    "total": 5000,
    "payment": "stripe_creditcard",
    "date": 1700000000,
    "status": "paid",
    "subscription": "660e8400-e29b-41d4-a716-446655440001",
    "locale": "en",
    "payment_retried": false,
    "payment_charge_date": 1700100000,
    "3d_secure_failure": false,
    "authorization_expiry": 1700604800,
    "affiliate_program": "770e8400-e29b-41d4-a716-446655440002",
    "affiliate": "880e8400-e29b-41d4-a716-446655440003",
    "late_failure": false,
    "has_subscriptions": false,
    "is_instalment": false,
    "fortnox_submitted": false,
    "start_date": 1700000000,
    "end_date": 1702592000,
    "has_notes": false,
    "customer_information": {
      "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "John Doe",
      "country": "NL",
      "email": "[email protected]",
      "stripe_customer_id": "cus_OxR5p8k3nM2qYz",
      "client_id": null,
      "billing_information": {
        "name": "John Doe",
        "country": "NL",
        "email": "[email protected]",
        "phone": "+31612345678",
        "address": "Keizersgracht 123",
        "postcode": "1015 CJ",
        "city": "Amsterdam",
        "ip": "203.0.113.42",
        "state": "Noord-Holland",
        "vat": "NL123456789B01",
        "company": "Acme B.V."
      },
      "shipping_information": {
        "address": "Prinsengracht 456",
        "postcode": "1016 HN",
        "country": "NL",
        "city": "Amsterdam",
        "state": "Noord-Holland",
        "name": "John Doe",
        "email": "[email protected]",
        "phone": "+31612345678",
        "company": "Acme B.V."
      }
    },
    "products": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Premium Widget",
        "quantity": 2,
        "type": "physical_product",
        "classification": "Tangible Goods",
        "currency": "EUR",
        "discount_allowed": true,
        "is_moss_product": false,
        "is_oss_product": false,
        "billing_cycle": null,
        "interval": null,
        "is_metered": false,
        "stripe_price_id": "price_1O2p3Q4r5S6t7U8v",
        "stripe_product_id": "prod_A1b2C3d4E5f6G7",
        "stripe_metered_id": null,
        "invoice_item_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "variation_id": "660e8400-e29b-41d4-a716-446655440001",
        "variation_label": "Large / Blue",
        "is_variant": false,
        "delivered": false,
        "cancelled": false,
        "sku": "WDG-PRM-001",
        "has_shipping": true,
        "weight": 2.5,
        "height": 10,
        "width": 20,
        "length": 30,
        "detailed_description": "string",
        "nshift_parcel_amount": 1,
        "nshift_quick_id": "string",
        "parcels": [],
        "trial_period": 14,
        "charge_shipping_during_trial": false,
        "taxes": {
          "inclusive": true,
          "eu_tax": true,
          "tax_rates": [],
          "shipping_tax_rates": []
        },
        "totals": {
          "unit_price": 2999,
          "item_total": 5998,
          "total": 7258,
          "discount": 0,
          "tax": 1260,
          "subtotal": 5998,
          "item_total_with_tax": 7258,
          "shipping": 500,
          "shipping_subtotal": 500,
          "shipping_discount": 0,
          "shipping_tax": 105,
          "shipping_total": 605,
          "exchange_rate": null,
          "price_conversion": false,
          "moss_taxable_amount": 0,
          "moss_tax_total": 0,
          "oss_taxable_amount": 0,
          "oss_tax_total": 0,
          "full_price": 0,
          "amount_paid": 7258,
          "amount_refunded": 0,
          "amount_cancelled": 0,
          "recurring_shipping_discount": 0,
          "recurring_shipping_cost": 500
        },
        "discounts": [
          {
            "id": "880e8400-e29b-41d4-a716-446655440003",
            "code": "SUMMER20",
            "discount": 600,
            "applies_to": []
          }
        ],
        "reservations": []
      }
    ],
    "shipping": {
      "has_shipping": true,
      "method": "Standard Delivery",
      "tracking": "3SXYZ1234567890",
      "shipped": false,
      "nshift_shipment_prepared": false,
      "nshift_shipment_stored": false,
      "is_nshift_shipment": false
    },
    "totals": {
      "total": 5000,
      "gateway_fees": 145,
      "affiliate_revenue": 0,
      "refunded_total": 0,
      "amount_paid": 5000,
      "amount_cancelled": 0,
      "subtotal": 4132,
      "discount": 0,
      "item_count": 2,
      "tax": 868,
      "shipping": 0,
      "shipping_total": 0,
      "shipping_discount": 0,
      "shipping_tax": 0,
      "moss_tax_total": 0,
      "moss_taxable_amount": 0,
      "item_total": 4132,
      "item_total_with_tax": 5000,
      "oss_taxable_amount": 0,
      "oss_tax_total": 0,
      "interest": 0,
      "amount_due": 0
    },
    "taxes": {
      "tax_rates": [
        {
          "id": "770e8400-e29b-41d4-a716-446655440002",
          "rate_percent": 21,
          "rate_amount": null,
          "label": "VAT 21%",
          "tax": 868,
          "moss": false,
          "jurisdiction": "de",
          "inclusive": true,
          "vat_tax": true,
          "applies_to": [
            "Premium Widget"
          ]
        }
      ],
      "shipping_tax_rates": [],
      "has_vat": true
    },
    "discounts": [
      {
        "id": "880e8400-e29b-41d4-a716-446655440003",
        "code": "SUMMER20",
        "discount": 600
      }
    ],
    "licenses": [
      {
        "key": "XXXX-YYYY-ZZZZ-1111",
        "product_id": "00000000-0000-0000-0000-000000000000"
      }
    ],
    "refunds": [
      {
        "amount": 5000,
        "date": "2024-01-15T14:30:00+00:00",
        "reason": "requested_by_customer"
      }
    ],
    "consents": {},
    "appendix": null,
    "transaction_id": "adf5c33d-3799-4d84-bf62-3b724c073ccf"
  }
}