---
title: "Get checkout configuration"
method: GET
path: "/checkout_configuration"
tags: ["CheckoutConfiguration"]
---

# Get checkout configuration

`GET /checkout_configuration`

## Request

- Base URL: `https://api.crevio.co/v1`
- URL: `https://api.crevio.co/v1/checkout_configuration`
- Auth: API key in header `Authorization`

Returns the account-wide checkout settings: country allow-list, tax collection, discount codes, the phone / shipping address / tax ID fields shown at checkout, quantity selection, and the post-purchase success URL. Read it before changing anything — omitted fields keep their current value on update.

## Response `200`

Checkout configuration

- CheckoutConfiguration
  - `object` string, required
  - `allowed_countries` string[], required: ISO 3166-1 alpha-2 allow-list; empty means every country can check out.
  - `collect_tax` boolean, required
  - `tax_behavior` 'unspecified' | 'inclusive' | 'exclusive', required
  - `tax_code` string, required
  - `allow_discount_codes` boolean, required
  - `show_tax_id_input` boolean, required
  - `show_phone_number_input` boolean, required
  - `collect_call_consent` boolean, required
  - `collect_shipping_address` boolean, required
  - `allow_multiple_quantity` boolean, required
  - `success_url` string, nullable, required

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Forbidden
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.
- `500`: Internal server error

---

[API](https://skmtc.dev/crevio/apis/crevio-api-v1.md) · [All operations](https://skmtc.dev/crevio/apis/crevio-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/crevio/apis/crevio-api-v1/revisions/2219f18ad651?raw)