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

# Get current invoice

`GET /v1/invoices/current`

Gets user estimated invoice for next month.

## Response `200`

Estimated invoice for next month
`WARNING`: almost all invoice data are `null` values, take that into consideration when using this endpoint

- object
  - `month_to_date` 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
  - `estimated` 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

- `401` — Unauthorized

---

[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)