---
title: "Open a hosted invoice"
method: GET
path: "/api/i/{id}"
tags: ["Hosted Links"]
---

# Open a hosted invoice

`GET /api/i/{id}`

Public, signed, 7-day link. Returns the rendered PDF (default) or the invoice JSON with `?format=json`. An invalid or expired signature returns 404.

## Path parameters

- `id` string, required

## Query parameters

- `t` string, required
- `format` 'json' | 'pdf'

## Response `200`

Invoice.

- InvoiceJsonResponse
  - `success` unknown
  - `invoice` InvoiceResponse — Computed invoice. Money fields are rounded to 2 decimals.
    - `number` string
    - `title` string
    - `date` string
    - `due_date` string
    - `currency` string
    - `language` string
    - `template` string
    - `from` Party
      - `name` string, required
      - `address` string
      - `email` string
      - `phone` string
      - `tax_id` string — VAT/GST/EIN
      - `registration_no` string
      - `website` string
      - `logo` string — Image URL (https) or data: URI (png/jpeg). ≤2.5MB. (from only)
    - `to` Party
      - `name` string, required
      - `address` string
      - `email` string
      - `phone` string
      - `tax_id` string — VAT/GST/EIN
      - `registration_no` string
      - `website` string
      - `logo` string — Image URL (https) or data: URI (png/jpeg). ≤2.5MB. (from only)
    - `items` object[]
      - `description` string
      - `quantity` number
      - `unit` string
      - `unit_price` number
      - `discount` number
      - `taxes` object[]
        - `name` string
        - `rate` number
        - `amount` number
      - `tax_amount` number
      - `line_total` number
    - `subtotal` number
    - `discount_total` number
    - `shipping` number
    - `tax_lines` object[]
      - `name` string
      - `amount` number
    - `total_tax` number
    - `rounding_adjustment` number
    - `grand_total` number
    - `deposit` number
    - `amount_paid` number
    - `balance_due` number
    - `status` 'paid' | 'partial' | 'unpaid'
    - `hosted_url` string — 7-day signed PDF link (present when features.hosted_link).
    - `hosted_expires_at` integer — Unix epoch seconds.
    - `qr` object
      - `source` 'hosted_link' | 'payment'
      - `type` string
  - `meta` Meta
    - `request_id` string
    - `processing_ms` integer
    - `credits_remaining` object
      - `hourly` integer
      - `weekly` integer
    - `rate_limits` object
      - `monthly_equivalent` integer
  - `anonymous` boolean

## Other responses

- `404` — Invalid or expired link.

---

[API](https://skmtc.net/invovate/apis/invovate-invoice-api.md) · [All operations](https://skmtc.net/invovate/apis/invovate-invoice-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/invovate/invovate-invoice-api/versions/9d493e278f33/schema)