---
title: "Get Invoice"
method: GET
path: "/v1/installations/{integrationConfigurationId}/billing/invoices/{invoiceId}"
tags: ["marketplace"]
---

# Get Invoice

`GET /v1/installations/{integrationConfigurationId}/billing/invoices/{invoiceId}`

Get Invoice details and status for a given invoice ID.<br/> <br/> See [Billing Events with Webhooks documentation](https://vercel.com/docs/integrations/create-integration/marketplace-api#working-with-billing-events-through-webhooks) on how to receive invoice events. This endpoint is used to retrieve the invoice details.

## Path parameters

- `integrationConfigurationId` string, required
- `invoiceId` string, required

## Response `200`

- object
  - `test` false | true — Whether the invoice is in the testmode (no real transaction created).
  - `invoiceId` string, required — Vercel Marketplace Invoice ID.
  - `externalId` string — Partner-supplied Invoice ID, if applicable.
  - `state` 'draft' | 'invoiced' | 'notpaid' | 'overdue' | 'paid' | 'pending' | 'refund_requested' | 'refunded' | 'scheduled', required — Invoice state.
  - `invoiceNumber` string — User-readable invoice number.
  - `invoiceDate` string, required — Invoice date. ISO 8601 timestamp.
  - `period` object, required — Subscription period for this billing cycle. ISO 8601 timestamps.
    - `start` string, required
    - `end` string, required
  - `paidAt` string — Moment the invoice was paid. ISO 8601 timestamp.
  - `refundedAt` string — Most recent moment the invoice was refunded. ISO 8601 timestamp.
  - `memo` string — Additional memo for the invoice.
  - `items` object[], required — Invoice items.
    - `billingPlanId` string, required — Partner's billing plan ID.
    - `resourceId` string — Partner's resource ID. If not specified, indicates installation-wide item.
    - `start` string — Start and end are only needed if different from the period's start/end. ISO 8601 timestamp.
    - `end` string — Start and end are only needed if different from the period's start/end. ISO 8601 timestamp.
    - `name` string, required — Invoice item name.
    - `details` string — Additional item details.
    - `price` string, required — Item price. A dollar-based decimal string.
    - `quantity` number, required — Item quantity.
    - `units` string, required — Units for item's quantity.
    - `total` string, required — Item total. A dollar-based decimal string.
  - `discounts` object[] — Invoice discounts.
    - `billingPlanId` string, required — Partner's billing plan ID.
    - `resourceId` string — Partner's resource ID. If not specified, indicates installation-wide discount.
    - `start` string — Start and end are only needed if different from the period's start/end. ISO 8601 timestamp.
    - `end` string — Start and end are only needed if different from the period's start/end. ISO 8601 timestamp.
    - `name` string, required — Discount name.
    - `details` string — Additional discount details.
    - `amount` string, required — Discount amount. A dollar-based decimal string.
  - `total` string, required — Invoice total amount. A dollar-based decimal string.
  - `refundReason` string — The reason for refund. Only applicable for states "refunded" or "refund_request".
  - `refundTotal` string — Refund amount. Only applicable for states "refunded" or "refund_request". A dollar-based decimal string.
  - `created` string, required — System creation date. ISO 8601 timestamp.
  - `updated` string, required — System update date. ISO 8601 timestamp.

## Other responses

- `400` — One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `404`
- `410`
- `429`

## Changes

- **2026-07-21** `2ae10ee9d21c` — 2 info
  - added the non-success response with the status `410`
  - added the non-success response with the status `429`

[Change history](https://skmtc.dev/vercel/apis/api/changes/v1/installations/:integrationConfigurationId/billing/invoices/:invoiceId/get.md)

---

[API](https://skmtc.dev/vercel/apis/api.md) · [All operations](https://skmtc.dev/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/vercel/api/revisions/e31ea8d3c1e7/schema)