---
title: "Get billing info"
method: GET
path: "/api/billing/billing-info"
---

# Get billing info

`GET /api/billing/billing-info`

## Request

- Base URL: `https://app.base44.com`
- URL: `https://app.base44.com/api/billing/billing-info`
- Auth: HTTP bearer

<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](/api-reference/open-invoice). Update the card with [Create billing portal session](/api-reference/create-billing-portal-session) or [Create payment method update session](/api-reference/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>

## Query parameters

- `include_all_provider_invoices` boolean: `true` adds the invoices from every other billing provider the workspace has used, except drafts and voided invoices. Defaults to `false`.

## Response `200`

The workspace's invoices, payment methods and billing contact.

- BillingInfo: The workspace's invoices, payment methods and billing contact.
  - `invoices` BillingInvoice[], required: The workspace's invoices, newest first.
    - `id` string, nullable, required: ID of the invoice. Pass it to [Open invoice](/api-reference/open-invoice) to get a link for a Wix invoice or a Google Ads charge. `null` on a Wix invoice that has no number yet.
    - `provider` 'stripe' | 'wix', required: Which billing provider issued the invoice.
    - `amount` number, nullable, required: Amount of the invoice, in major units of `currency` (dollars, not cents). `null` on a Wix invoice with no total.
    - `currency` string, required: Three-letter currency code, such as `USD`.
    - `status` string, nullable, required: Status of the invoice. Stripe invoices use Stripe's statuses, such as `open` or `paid`. Wix invoices are `paid`, `refunded` or `chargeback`, or `null` for any other kind.
    - `date` integer, nullable, required: When the invoice was issued, as a Unix timestamp in seconds.
    - `period_start` integer, nullable, required: Start of the billed period, as a Unix timestamp in seconds. `null` on Wix invoices with no plan line, such as top-ups.
    - `period_end` integer, nullable, required: End of the billed period, as a Unix timestamp in seconds.
    - `hosted_invoice_url` string, nullable, required: Hosted page for the invoice. On a Wix invoice, open it with [Open invoice](/api-reference/open-invoice) instead.
    - `invoice_pdf` string, nullable, required: Link to the invoice PDF. Stripe invoices only. Always `null` on Wix invoices.
    - `description` string, nullable, required: What the invoice is for, such as the plan and billing period.
    - `billing_reason` string, nullable, required: Why Stripe issued the invoice, such as `subscription_cycle` or `subscription_update`. Always `null` on Wix invoices.
    - `disputed` boolean, nullable: `true` while the payment is under a dispute. Stripe invoices only. Not returned on Wix invoices.
  - `payment_methods` BillingPaymentMethod[], required: Saved payment methods.
    - `id` string, nullable, required: ID of the payment method at the billing provider.
    - `brand` string, required: Card brand, such as `visa`.
    - `last4` string, required: Last four digits of the card. On a Wix-billed workspace this is Wix's label for the payment method, which isn't always four digits.
    - `exp_month` integer, nullable, required: Expiry month. `null` on Wix-billed workspaces.
    - `exp_year` integer, nullable, required: Expiry year. `null` on Wix-billed workspaces.
    - `is_default` boolean, nullable: `true` for the card Stripe charges by default. Stripe only. Not returned on Wix-billed workspaces.
  - `billing_information` BillingContact, required: The billing contact and address.
    - `name` string, nullable, required: Name on the billing account.
    - `email` string, nullable, required: Billing email. On a Wix-billed workspace this is the workspace owner's email.
    - `billing_address` string, nullable, required: Billing address on one line, comma-separated.
  - `default_card_payment_method_id` string, nullable, required: ID of the card Stripe charges by default, or `null` when the default isn't a card. Always `null` on Wix-billed workspaces.

## Other responses

- `400`: The workspace is billed through Wix but has no Wix billing account.
- `401`: Missing or invalid credentials. A read-only token gets this response too.
- `403`: You aren't the workspace owner.
- `422`: Validation Error
- `429`: Rate limit exceeded. The base rate limit is 60 requests per minute per user. See [Rate limits](/developers/references/apps-api/get-started/rate-limits) for the multiplier your plan gets.

## Changes

> 66 revisions in range; 1 not diffed.

- **2026-10-26** `395a6758864a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/adexad/apis/base44-app-management-api/changes/api/billing/billing-info/get.md)

---

[API](https://skmtc.dev/adexad/apis/base44-app-management-api.md) - [All operations](https://skmtc.dev/adexad/apis/base44-app-management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adexad/apis/base44-app-management-api/revisions/d877a932dc19?raw)