List invoices

GET

https://api.smallest.ai/payment/v1/invoices

GET

/payment/v1/invoices

1 import requests
2 
3 url = "https://api.smallest.ai/payment/v1/invoices"
4 
5 payload = {}
6 headers = {
7     "Authorization": "Bearer <token>",
8     "Content-Type": "application/json"
9 }
10 
11 response = requests.get(url, json=payload, headers=headers)
12 
13 print(response.json())

1 {
2   "success": true,
3   "data": [
4     {
5       "id": "in_1J2Y3Z4aBcDeFgHiJkLmNoPq",
6       "object": "invoice",
7       "amount_due": 2500,
8       "amount_paid": 2500,
9       "amount_remaining": 0,
10       "application_fee_amount": null,
11       "attempt_count": 1,
12       "attempted": true,
13       "auto_advance": false,
14       "billing_reason": "subscription_create",
15       "charge": "ch_1J2Y3Z4aBcDeFgHiJkLmNoPq",
16       "collection_method": "charge_automatically",
17       "created": 1685600000,
18       "currency": "usd",
19       "customer": "cus_JkLmNoPqRsTuVwXy",
20       "customer_email": "billing@example.com",
21       "description": "Monthly subscription invoice",
22       "discount": null,
23       "due_date": null,
24       "ending_balance": 0,
25       "hosted_invoice_url": "https://invoice.stripe.com/i/acct_1J2Y3Z4aBcDeFgHi/invst_1J2Y3Z4aBcDeFgHiJkLmNoPq",
26       "invoice_pdf": "https://pay.stripe.com/invoice/acct_1J2Y3Z4aBcDeFgHi/invst_1J2Y3Z4aBcDeFgHiJkLmNoPq/pdf",
27       "lines": {
28         "object": "list",
29         "data": [
30           {
31             "id": "il_1J2Y3Z4aBcDeFgHiJkLmNoPq",
32             "object": "line_item",
33             "amount": 2500,
34             "currency": "usd",
35             "description": "Pro Plan (Monthly)",
36             "quantity": 1,
37             "type": "subscription"
38           }
39         ],
40         "has_more": false,
41         "total_count": 1,
42         "url": "/v1/invoices/in_1J2Y3Z4aBcDeFgHiJkLmNoPq/lines"
43       },
44       "number": "00001234",
45       "paid": true,
46       "period_end": 1685596400,
47       "period_start": 1683004400,
48       "receipt_number": "1234-5678",
49       "starting_balance": 0,
50       "statement_descriptor": "SMALLEST AI",
51       "status": "paid",
52       "status_transitions": {
53         "finalized_at": 1685600100,
54         "marked_uncollectible_at": null,
55         "paid_at": 1685600200,
56         "voided_at": null
57       },
58       "subscription": "sub_JkLmNoPqRsTuVwXy",
59       "subtotal": 2500,
60       "tax": null,
61       "total": 2500,
62       "webhooks_delivered_at": 1685600300
63     }
64   ]
65 }

Returns up to 20 of the most recent Stripe invoices for the caller’s organization. Each item is the raw Stripe Invoice object; use the canonical Stripe reference at stripe.com/docs/api/invoices/object for field-level semantics.

Organizations that have never been charged (free-tier only) return an empty array.

Returns up to 20 of the most recent Stripe invoices for the caller's organization. Each item is the raw Stripe `Invoice` object; use the canonical Stripe reference at [stripe.com/docs/api/invoices/object](https://stripe.com/docs/api/invoices/object) for field-level semantics. Organizations that have never been charged (free-tier only) return an empty array.

Authentication

AuthorizationBearer

API key from the console ApiKey collection, sent as Bearer token. Also accepts session cookies for browser-based auth.

Response

Up to 20 recent Stripe invoices for the caller's organization.

successboolean

datalist of maps from strings to any

Up to 20 recent Stripe Invoice objects for the caller’s organization. Fields follow the canonical Stripe shape. Keys most callers use: id, status, amount_paid, amount_due, currency, created, hosted_invoice_url, invoice_pdf, number.

Errors

401

Unauthorized Error