---
title: "Get invoice summaries"
method: GET
path: "/public/v2/billing/invoices"
tags: ["Billing"]
---

# Get invoice summaries

`GET /public/v2/billing/invoices`

## Request

- Base URL: `https://starlink.com/api`
- URL: `https://starlink.com/api/public/v2/billing/invoices`
- Auth: HTTP bearer

Required permission: Financial, View.

## Query parameters

- `page` integer

## Response `200`

Invoices retrieved

- InvoiceSummaryResponsePaginatedServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean
  - `content` InvoiceSummaryResponsePaginated
    - `pageIndex` integer
    - `limit` integer
    - `isLastPage` boolean
    - `results` InvoiceSummaryResponse[], nullable
      - `invoiceId` string: The invoice identifier. Example: INV-DF-US-1234ABCD
      - `description` string: The invoice description. Example: Order
      - `currency` string: The ISO 4217 alphabetic currency code of the invoice. Example: USD
      - `amount` number, double: The total amount of the invoice
      - `dueAmount` number, double: The amount still owed on the invoice
      - `invoiceDate` string, date-time: The date the invoice was issued
      - `dueDate` string, date-time, nullable: The date payment is due
      - `status` 'Unknown' | 'Paid' | 'Cancelled' | 'Overdue' | 'DueSoon' | 'Outstanding' | 'Migrated': The status of an invoice
    - `totalCount` integer

## Other responses

- `400`: Bad request. Invalid or missing parameter
- `401`: Unauthorized
- `403`: Missing required permission for this endpoint or resource
- `422`: Failed to retrieve invoices

## Changes

- **2026-11-02** `dfd7014cfd6d`: 1 warning
  - added the new `Migrated` enum value to the `content/results/items/status` response property for the response status `200`

[Operation history](https://skmtc.dev/starlink/apis/starlink-management-api/changes/public/v2/billing/invoices/get.md)

---

[API](https://skmtc.dev/starlink/apis/starlink-management-api.md) - [All operations](https://skmtc.dev/starlink/apis/starlink-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/starlink/apis/starlink-management-api/revisions/dfd7014cfd6d?raw)