List Invoices
curl --request GET \
--url https://api.bunship.com/api/v1/organizations/{orgId}/billing/invoices \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.bunship.com/api/v1/organizations/{orgId}/billing/invoices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.bunship.com/api/v1/organizations/{orgId}/billing/invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bunship.com/api/v1/organizations/{orgId}/billing/invoices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bunship.com/api/v1/organizations/{orgId}/billing/invoices"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bunship.com/api/v1/organizations/{orgId}/billing/invoices")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bunship.com/api/v1/organizations/{orgId}/billing/invoices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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"
}
]
}
Billing
List Invoices
Get the organization’s invoice history
GET
/
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>'import requests
url = "https://api.bunship.com/api/v1/organizations/{orgId}/billing/invoices"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.bunship.com/api/v1/organizations/{orgId}/billing/invoices', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bunship.com/api/v1/organizations/{orgId}/billing/invoices",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.bunship.com/api/v1/organizations/{orgId}/billing/invoices"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bunship.com/api/v1/organizations/{orgId}/billing/invoices")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bunship.com/api/v1/organizations/{orgId}/billing/invoices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"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
Organization identifier.
Query Parameters
Number of invoices to return. Between 1 and 100.
Response
Always
true on success.Array of invoice objects.
Show invoice properties
Show invoice properties
Stripe invoice ID.
Invoice number.
"draft", "open", "paid", "void", or "uncollectible".Invoice amount in smallest currency unit (e.g., cents).
Three-letter ISO currency code (e.g.,
"usd").ISO 8601 creation timestamp.
ISO 8601 due date.
ISO 8601 payment timestamp.
URL to view the invoice on Stripe.
URL to download the invoice PDF.
{
"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..."
⌘I

