Skip to main content
GET
https://api.bunship.com
/
api
/
v1
/
organizations
/
{orgId}
/
billing
/
invoices
List Invoices
curl --request GET \
  --url https://api.bunship.com/api/v1/organizations/{orgId}/billing/invoices \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "data": [
    {
      "id": "in_1abc123",
      "number": "INV-0001",
      "status": "paid",
      "amount": 2900,
      "currency": "usd",
      "created": "2024-01-15T10:00:00Z",
      "dueDate": "2024-02-14T10:00:00Z",
      "paidAt": "2024-01-15T10:05:00Z",
      "hostedInvoiceUrl": "https://invoice.stripe.com/i/acct_abc/inv_123",
      "invoicePdf": "https://pay.stripe.com/invoice/acct_abc/inv_123/pdf"
    }
  ]
}
Returns a list of invoices for the organization from Stripe, including payment status and download links.

​
Auth

Requires a valid Bearer token. User must be a member of the organization.

​
Path Parameters

​
orgId
string
required
Organization identifier.

​
Query Parameters

​
limit
number
default:10
Number of invoices to return. Between 1 and 100.

​
Response

​
success
boolean
Always true on success.
​
data
array
Array of invoice objects.
{
  "success": true,
  "data": [
    {
      "id": "in_1abc123",
      "number": "INV-0001",
      "status": "paid",
      "amount": 2900,
      "currency": "usd",
      "created": "2024-01-15T10:00:00Z",
      "dueDate": "2024-02-14T10:00:00Z",
      "paidAt": "2024-01-15T10:05:00Z",
      "hostedInvoiceUrl": "https://invoice.stripe.com/i/acct_abc/inv_123",
      "invoicePdf": "https://pay.stripe.com/invoice/acct_abc/inv_123/pdf"
    }
  ]
}

​
Example

curl "https://api.bunship.com/api/v1/organizations/org_cld2abc123def456/billing/invoices?limit=20" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."