---
title: "Get invoice details"
method: GET
path: "/public/v2/billing/invoices/{invoiceId}"
tags: ["Billing"]
---

# Get invoice details

`GET /public/v2/billing/invoices/{invoiceId}`

## Request

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

Required permission: Financial, View.

## Path parameters

- `invoiceId` string, required

## Response `200`

Invoice retrieved

- InvoiceDetailResponseServiceResponse
  - `errors` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `warnings` ValidationResult[], nullable
    - `memberNames` string[], nullable
    - `errorMessage` string, nullable
  - `information` string[], nullable
  - `isValid` boolean
  - `content` InvoiceDetailResponse
    - `invoiceId` string: The invoice identifier. Example: INV-DF-US-1234ABCD
    - `orderReferenceId` string: The order this invoice was generated from
    - `currency` string: The ISO 4217 alphabetic currency code of the invoice. Example: USD
    - `dueAmount` number, double: The amount still owed on the invoice
    - `paidAmount` number, double: The amount already paid on the invoice
    - `invoiceDate` string, date-time: The date the invoice was issued
    - `dueDate` string, date-time, nullable: The date payment is due
    - `invoiceLines` InvoiceLineDetailResponse[]: The line items on the invoice
      - `productReferenceId` string: The product identifier
      - `productDescription` string: The product description
      - `serviceName` string, nullable: The service name
      - `serviceLineNumbers` string[]: The service line numbers this line applies to
      - `quantity` number, double: The quantity billed
      - `unitPrice` number, double: The unit price, before tax
      - `taxAmount` number, double: The total tax
      - `subTotal` number, double: The line total, before tax
      - `servicePeriodStartDate` string, date-time, nullable: The start of the service period
      - `servicePeriodEndDate` string, date-time, nullable: The end of the service period

## Other responses

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

---

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