---
title: "Get a credit purchase"
method: GET
path: "/api/v1/credits/purchases/{purchase_id}"
tags: ["Credits"]
---

# Get a credit purchase

`GET /api/v1/credits/purchases/{purchase_id}`

## Request

- Base URL: `https://app.argorant.com`
- URL: `https://app.argorant.com/api/v1/credits/purchases/{purchase_id}`
- Auth: HTTP bearer

One purchase, with whether it is paid, waiting for payment, not charged or expired, and how many credits it added.

| Cost | What it does | Key scopes |
| --- | --- | --- |
| Free | Reads only | `argorant:read_counts` |

## Path parameters

- `purchase_id` string, uuid, required

## Headers

- `X-Request-Id` string

## Response `200`

OK

- CreditPurchase
  - `purchase_id` string, uuid: Purchase id, the same as the quote id.
  - `status` 'paid' | 'awaiting_payment' | 'processing' | 'not_charged' | 'expired': paid: credits added. awaiting_payment: send checkout_url to the person who pays. processing: wait a minute. not_charged: the card was not charged. expired: the link ran out unpaid.
  - `paid_with` string, nullable: saved_card or payment_link.
  - `card` string, nullable: The saved card that was charged, for example card ending 4242.
  - `credits` integer: Credits bought.
  - `credits_added` integer: Credits added to the account.
  - `amount_cents` integer: Amount in cents.
  - `currency` string: Currency.
  - `checkout_url` string, uri, nullable: Payment page for the person who pays.
  - `message` string: What happened, in one or two sentences.
  - `saved_card` object: Present when the saved card was not used, with used (false), code and reason.
  - `replayed` boolean: Present and true when this is the answer of an earlier call with the same quote.

## Other responses

- `401`: 401 Unauthorized. `unauthorized` when the API key is missing, wrong or revoked.
- `403`: 403 Forbidden. `scope_missing` when the key lacks argorant:read_counts.
- `404`: 404 Not found. `not_found` when the item does not exist in your workspace.
- `429`: 429 Too many requests. `rate_limited` when too many requests this minute.

---

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