---
title: "Start a card checkout for a fixed date range"
method: POST
path: "/v1/public/range-checkout"
tags: ["purchase"]
---

# Start a card checkout for a fixed date range

`POST /v1/public/range-checkout`

## Request

- Base URL: `https://outcometick.com`
- URL: `https://outcometick.com/v1/public/range-checkout`
- Auth: none required

Spends money or credits. An agent must show the quote to the user and get explicit approval before calling this.

## Request body

- object
  - `venue` 'polymarket' | 'predict' | 'all', required
  - `from` string, date, required: UTC day, YYYY-MM-DD
  - `to` string, date, required: UTC day, YYYY-MM-DD
  - `locale` 'en' | 'zh': Decides the currency (zh pays in CNY) and the return page

## Response `200`

OK

- CheckoutUrl
  - `url` string, uri, required: Stripe-hosted payment page; a person opens it

## Other responses

- `400`: Range refused
- `429`: Rate limited; retry after the Retry-After header
- `503`: Temporarily unavailable; retry

---

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