---
title: "Get invoice URL for a payment"
method: GET
path: "/api/v1/billing/payments/{payment_id}/invoice"
tags: ["billing"]
---

# Get invoice URL for a payment

`GET /api/v1/billing/payments/{payment_id}/invoice`

## Request

- Base URL: `https://api.crosmos.dev`
- URL: `https://api.crosmos.dev/api/v1/billing/payments/{payment_id}/invoice`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/crosmos/apis/crosmos-api/docs/api/v1/billing/payments/:payment_id/invoice/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a URL to the order's invoice PDF. Polar generates invoices lazily: if one does not exist yet this triggers generation and responds 202, and the client should retry shortly.

## Path parameters

- `payment_id` string, uuid, required

## Response `200`

Invoice URL

- InvoiceResponse
  - `invoice_url` string, uri, required

## Other responses

- `202`: Invoice is being generated; retry shortly
- `401`: Unauthorized
- `403`: Insufficient role
- `404`: No such payment for this org
- `429`: Rate limited
- `502`: Provider error

## Changes

- **2026-08-25** `55772030ddd3`: 4 breaking, 9 warning
  - the response property `fields` became nullable for the status `401`
  - the response property `fields` became nullable for the status `403`
  - the `fields` response's property type changed from `object` to no type for status `401`
  - the `fields` response's property type changed from `object` to no type for status `403`
  - …9 more
- **2026-08-19** `b38f8e603649`: 2 breaking, 9 info
  - the `fields` response's property type changed from no type to `object` for status `401`
  - the `fields` response's property type changed from no type to `object` for status `403`
  - added the optional property `code` to the response with the `404` status
  - added the optional property `code` to the response with the `429` status
  - …7 more
- **2026-07-26** `a828d1399648`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/crosmos/apis/crosmos-api/changes/api/v1/billing/payments/:payment_id/invoice/get.md)

---

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