---
title: "Get invoice"
method: GET
path: "/v1/invoices/{id}"
tags: ["Invoices"]
---

# Get invoice

`GET /v1/invoices/{id}`

Gets basic information of the specified invoice.

## Path parameters

- `id` integer, required

## Query parameters

- `organization_id` integer, required

## Response `200`

Invoice basic information

- Invoice — Invoice resource
  - `id` integer — Invoice ID
  - `start_date` string, date — Billing start date
  - `end_date` string, date — Billing end date
  - `organization_id` integer — Organization resource ID
  - `created_at` string, date — Invoice creation date
  - `updated_at` string, date — Invoice last update date
  - `total_cents` integer — Total invoice amount (cents)
  - `stripe_id` string — Invoice Stripe ID
  - `requests` integer — Total number of DNS requests
  - `paid` boolean — Invoice has been paid (may be null)
  - `closed` boolean — Invoice has been closed (may be null)
  - `forgiven` boolean — Invoice has been forgiven (may be null)
  - `payment_attempts` integer — Total number of payment attempts (may be null)
  - `payment_first_attempt` string, date — First payment attempt (may be null)
  - `payment_last_attempt` string, date — Last payment attempt (may be null)
  - `payment_date` string, date — Payment date (may be null)
  - `payment_receipt_number` string — Receipt number (may be null)
  - `organization_name` string — Organization name
  - `invoice_item_groups` InvoiceItemGroup[] — Invoice item groups
    - `id` integer — Invoice item group ID
    - `invoice_id` integer — Invoice ID
    - `organization_name` string — Organization name
    - `organization_id` integer — Organization resource ID
    - `subtotal_cents` integer — Total amount (cents) for item group
    - `created_at` string, date — Item group creation date
    - `updated_at` string, date — Item group last update date
    - `invoice_items` InvoiceItem[] — Item group associated items
      - `id` integer — Invoice item ID
      - `invoice_id` integer — Invoice ID
      - `network_name` string — Network name
      - `network_id` integer — Network ID
      - `cents` integer — Total amount (cents) for item
      - `requests` integer — Total number of DNS requests for item
      - `created_at` string, date — Item creation date
      - `updated_at` string, date — Item last update date
      - `stripe_id` string — Invoice Stripe ID
      - `discounted` boolean — Item discounted
      - `invoice_item_group_id` integer — Invoice item group ID
  - `invoice_items` InvoiceItem[] — Invoice items
    - `id` integer — Invoice item ID
    - `invoice_id` integer — Invoice ID
    - `network_name` string — Network name
    - `network_id` integer — Network ID
    - `cents` integer — Total amount (cents) for item
    - `requests` integer — Total number of DNS requests for item
    - `created_at` string, date — Item creation date
    - `updated_at` string, date — Item last update date
    - `stripe_id` string — Invoice Stripe ID
    - `discounted` boolean — Item discounted
    - `invoice_item_group_id` integer — Invoice item group ID

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found

---

[API](https://skmtc.net/dnsfilter/apis/dnsfilter-api.md) · [All operations](https://skmtc.net/dnsfilter/apis/dnsfilter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dnsfilter/dnsfilter-api/revisions/29e5e6ee3316/schema)