<Info>This API is in beta. Endpoints, fields, and behavior may still change, so avoid depending on it in production.</Info>

Returns your workspace's invoices, saved payment methods and billing contact. Only the workspace owner can call this.

What you get depends on how the workspace is billed:

• Stripe: the 50 most recent Stripe invoices, the saved cards with their expiry dates, and which card is the default.
• Wix: every Wix invoice, the payment method on the plan, and the billing contact with the workspace owner's email.

Without include_all_provider_invoices, a Wix-billed workspace also gets its Google Ads charges, and a workspace that moved off Wix keeps its Wix invoices. Set include_all_provider_invoices to true to add the invoices from every other billing provider the workspace has used instead, except drafts and voided invoices. Each invoice names its provider in provider.

Invoices from a provider other than the one billing the workspace are left out when that provider doesn't answer within a few seconds. On a Wix-billed workspace, Wix invoices and payment methods are also left out when Wix doesn't answer. So an empty list doesn't always mean there's nothing there.

Open a Wix invoice or a Google Ads charge with Open invoice. Update the card with Create billing portal session or Create payment method update session.

<Note>Missing or invalid credentials, and a read-only token, return 401 here.</Note>

<Warning>The response includes fields beyond the ones documented here. Don't rely on undocumented response fields, as they can change at any time.</Warning>

{
  "invoices": [
    {
      "amount": 50,
      "billing_reason": "subscription_cycle",
      "currency": "USD",
      "date": 1761379200,
      "description": "Pro Plan - Monthly",
      "disputed": false,
      "hosted_invoice_url": "https://invoice.stripe.com/i/acct_1N3XrmDr56L89dkK/live_YWNjdF8xTjNYcm1EcjU2TDg5ZGtL",
      "id": "in_1QZk4LDr56L89dkKx3bT0aPq",
      "invoice_pdf": "https://pay.stripe.com/invoice/acct_1N3XrmDr56L89dkK/live_YWNjdF8xTjNYcm1EcjU2TDg5ZGtL/pdf",
      "period_end": 1763971200,
      "period_start": 1761379200,
      "provider": "stripe",
      "status": "paid"
    }
  ],
  "payment_methods": [
    {
      "brand": "visa",
      "exp_month": 12,
      "exp_year": 2028,
      "id": "pm_1QZk4LDr56L89dkK2c9sXy0b",
      "is_default": true,
      "last4": "4242"
    }
  ],
  "billing_information": {
    "name": "Nordwind Furniture Ltd",
    "email": "owner@nordwind.example",
    "billing_address": "12 Harbour St, Bristol, BS1 4QA, GB"
  },
  "default_card_payment_method_id": "pm_1QZk4LDr56L89dkK2c9sXy0b"
}