---
title: "Read payment and credit delivery status"
method: GET
path: "/v1/credit-checkouts/{id}"
tags: ["Credits"]
---

# Read payment and credit delivery status

`GET /v1/credit-checkouts/{id}`

## Request

- Base URL: `https://api.masko.ai`
- URL: `https://api.masko.ai/v1/credit-checkouts/{id}`
- Auth: HTTP bearer

Read-only. Only the creating user in the same credential workspace may read the checkout; team ownership must still be active. A paid session does not guarantee credits have been delivered yet. credits_added is true only when the credit ledger contains the matching grant. Does not grant credits or return customer/payment credentials.

## Path parameters

- `id` string, required

## Response `200`

Payment and credit delivery status

- object
  - `data` object, required
    - `id` string, required
    - `status` 'open' | 'complete' | 'expired' | 'null', nullable, required
    - `payment_status` 'paid' | 'unpaid' | 'no_payment_required', required
    - `credits` integer, required
    - `credits_added` boolean, required
    - `organization_id` string, uuid, nullable, required
    - `balance` number, required
    - `amount_total` integer, nullable, required
    - `currency` string, nullable, required

## Other responses

- `400`: Invalid input or missing Idempotency-Key
- `401`: Authentication required
- `403`: Write permission or active team ownership required
- `404`: Checkout not found for this user and workspace
- `409`: Idempotency key reused with different input or request still in progress
- `500`: Checkout provider or database unavailable
- `503`: Idempotency receipt unavailable; retry only with the same key

---

[API](https://skmtc.dev/masko/apis/masko-api.md) · [All operations](https://skmtc.dev/masko/apis/masko-api/llms.txt) · [OpenAPI document](https://skmtc.dev/masko/apis/masko-api/revisions/91eb3006a92f?raw)