---
title: "Read Billing Payment Details"
method: GET
path: "/api/v1/billing/payment-details"
tags: ["billing"]
---

# Read Billing Payment Details

`GET /api/v1/billing/payment-details`

What the portal should be offered for, if anything.

Admin-only, like the portal it points to: a member cannot act on it.

## Response `200`

Successful Response

- BillingPaymentDetailsResponse — What the workspace's Stripe customer still owes, if anything. A paid workspace with no card is asked for one: staff conversion puts a workspace on the plan without Stripe, and until a card is added every purchase it is offered refuses. A workspace that has a card but no address is asked for the address instead — it paid before checkout required one. Nothing is refused while the address is missing.
  - `address_on_file` boolean, required
  - `payment_method_on_file` boolean, required

## Other responses

- `404` — Not Found
- `503` — Service Unavailable

## Changes

- **2026-09-23** `8dc47faf0418` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/maia-analytics/apis/maia-api/changes/api/v1/billing/payment-details/get.md)

---

[API](https://skmtc.dev/maia-analytics/apis/maia-api.md) · [All operations](https://skmtc.dev/maia-analytics/apis/maia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/maia-analytics/apis/maia-api/revisions/8dc47faf0418?raw)