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

# Update billing customer details

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

Updates billing customer details for the specified organization.

## Request body

- UpdateBillingCustomerRequest
  - `billing_email` string, email, required

## Response `200`

Billing customer updated

- 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

- `400` — Error returned when the request is malformed or contains invalid parameters
- `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/format changed from `string`/`` to ``/`` 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

[Full history](https://skmtc.dev/xataio/apis/xata-api/changes/organizations/:organizationID/billing/customer/patch.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-service-production.skmtc.workers.dev/v1/apis/xataio/xata-api/revisions/16b3a31dfdf8/schema)