---
title: "Get billing customer details"
method: GET
path: "/organizations/{organizationID}/billing/customer"
tags: ["Billing"]
---

# Get billing customer details

`GET /organizations/{organizationID}/billing/customer`

## Request

- Base URL: `https://api.xata.tech`
- URL: `https://api.xata.tech/organizations/{organizationID}/billing/customer`
- Auth: OAuth 2
  - Implicit: `https://auth.xata.io/realms/xata/protocol/openid-connect/auth`
  - Scopes: `org:read`

Retrieves billing customer details for the specified organization.

## Response `200`

Billing customer details

- BillingCustomerResponse
  - `billing_email` string, email, required
  - `marketplace` 'aws', required: Marketplace provider associated with an organization.
  - `collection_method` 'unknown' | 'stripe_payment_method' | 'marketplace' | 'bank_transfer', required: How billing payment is collected for the organization.
  - `can_collect_payment` boolean, required
  - `has_payment_method` boolean, required: True when the customer has a valid Stripe default card payment method.
  - `default_payment_method` BillingPaymentMethod, required
    - `card` BillingPaymentMethodCard, required
      - `brand` string, required
      - `last4` string, required
      - `expiry_month` integer, required
      - `expiry_year` integer, required
  - `credits` BillingCredit[], required
    - `id` string, required
    - `balance` number, double, required: Remaining credit balance.
    - `effective_date` string, date-time, required: Date when the credit becomes usable.
    - `expiry_date` string, date-time, nullable, required: Date when the credit expires, or null for credits that do not expire.
    - `maximum_initial_balance` number, double, required: Initial credit balance before any usage.
    - `status` 'active' | 'pending_payment', required
  - `credit_details` BillingCreditDetails, required
    - `total_lifetime_credits` number, double, required
    - `last_expiry` string, date-time, nullable, required
    - `last_expiry_with_balance` string, date-time, nullable, required
    - `active_credits` BillingCredit[], required: Credits with active status, a reached effective date, positive balance, and no past expiry.
      - `id` string, required
      - `balance` number, double, required: Remaining credit balance.
      - `effective_date` string, date-time, required: Date when the credit becomes usable.
      - `expiry_date` string, date-time, nullable, required: Date when the credit expires, or null for credits that do not expire.
      - `maximum_initial_balance` number, double, required: Initial credit balance before any usage.
      - `status` 'active' | 'pending_payment', required
    - `last_active_credit_expiry` string, date-time, nullable, required
    - `total_active_credits` number, double, required
    - `days_until_last_active_credit_expiry` integer, nullable, required: Days until the last active credit expiry, or null when there is no future active credit expiry.
    - `days_until_last_expiry_with_balance` integer, nullable, required: Days until the last positive-balance credit expiry, or null when there is no future positive-balance credit expiry.

## Other responses

- `401`: Error returned when authentication or authorization fails
- `403`: Error returned when authentication or authorization fails
- `404`: Generic error response
- `5XX`: Unexpected Error

## Changes

- **2026-08-20** `e19fb49d80b1`: 2 info
  - added the required property `can_collect_payment` to the response with the `200` status
  - added the required property `collection_method` to the response with the `200` status
- **2026-07-14** `fcbf82ebfc05`: 1 warning
  - deleted the `path` request parameter `organizationID`
- **2026-07-08** `bed0f79de08d`: 1 breaking, 1 info
  - the `marketplace` response's property type changed from `string` to no type for status `200`
  - added `#/components/schemas/OrganizationMarketplaceProvider` to the `marketplace` response property `allOf` list for the response status `200`
- **2026-07-08** `714fdbb2cbab`: 1 info
  - added the required property `marketplace` to the response with the `200` status
- **2026-06-12** `e6cf7c4377e3`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/xataio/apis/xata-api/changes/organizations/:organizationID/billing/customer/get.md)

---

[API](https://skmtc.dev/xataio/apis/xata-api.md) - [All operations](https://skmtc.dev/xataio/apis/xata-api/llms.txt) - [OpenAPI document](https://skmtc.dev/xataio/apis/xata-api/revisions/4bc5ad58a6c6?raw)