---
title: "Upcoming Invoice"
method: GET
path: "/v0/billing/upcoming_invoice"
tags: ["billing"]
---

# Upcoming Invoice

`GET /v0/billing/upcoming_invoice`

## Response `200`

Successful Response

- InvoiceDraftStateView
  - `data_usage_charge` integer, required
  - `credit_applicable` integer, required
  - `total_data_usage_balance` integer, required
  - `data_usage` InvoiceDataUsageView, required
    - `data_usage_charge` integer, required
    - `total_charge` integer, required
    - `data` DataUsageByDatasetView[], required
      - `dataset_id` string, required
      - `dataset_display_name` string, required
      - `usage_detail` object, required
      - `data_usage_charge` integer, required
  - `subscriptions` SubscriptionDetail, required
    - `licenses` LicenseSubscriptionItem[], required
      - `license_subscription_id` integer, required
      - `team_id` string, required
      - `provider` string, required
      - `name` string, required
      - `description` string, required
      - `professional` boolean, required
      - `asset_class` string[], required
      - `cost` integer, required
      - `next_billing_date` string, nullable, required
      - `current_cycle_start` string, required
      - `current_cycle_end` string, required
      - `termination_date` string, required
      - `billing_interval` integer, required
      - `status` string, required
      - `service_group` string, nullable, required
      - `reference_data_license_tier` string, nullable
      - `symbols_used` integer, nullable
      - `symbols_allowed` integer, nullable
    - `plans` PlanSubscriptionItem[], required
      - `plan_subscription_id` integer, required
      - `team_id` string, required
      - `service_name` string, required
      - `service_description` string, required
      - `service_type` string, required
      - `service_tier` string, required
      - `service_group` string, required
      - `dataset` string, required
      - `cost` integer, required
      - `next_billing_date` string, nullable, required
      - `current_cycle_start` string, required
      - `current_cycle_end` string, required
      - `termination_date` string, required
      - `billing_interval` integer, required
      - `status` string, required
      - `sub_datasets` string[]
      - `historical_data_ready_datasets` string[]
      - `live_data_ready_datasets` string[]
      - `license_flow_ready_datasets` string[]
      - `allowed_live_datasets` string[]

## Other responses

- `401` — If user authentication fails
- `403` — If user does not have sufficient permissions

---

[API](https://skmtc.net/databento/apis/databento-openapi-specification.md) · [All operations](https://skmtc.net/databento/apis/databento-openapi-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/databento/databento-openapi-specification/revisions/08ef3d01f5b8/schema)