---
title: "Tiered payment receipt (tier 2)"
method: GET
path: "/pay/tier2"
tags: ["pay", "tier2"]
---

# Tiered payment receipt (tier 2)

`GET /pay/tier2`

## Request

- Base URL: `https://api.truthbear.co`
- URL: `https://api.truthbear.co/pay/tier2`
- Auth: none declared

Tiered payment receipt (tier 2): pay once with x402 and get back a short-lived receipt token that /pay/verify checks for you. The tier is fixed by the path - you do not send it. Optional ?ref= carries your own opaque reference, such as a query hash, straight through to the receipt. This mints a receipt rather than returning data, so there is no lookup that can come back empty. Also searched as: two leg combo; paired reading bundle.

## Query parameters

- `tier` string
- `ref` string

## Response `200`

Paid response

- object
  - `ok` boolean
  - `tier` integer
  - `ref` string, nullable
  - `paid_via` string
  - `receipt` string
  - `exp` integer

## Other responses

- `402`: Payment Required
- `422`: No data for this query - no_charge:true, you are NOT billed

---

[API](https://skmtc.dev/truthbear/apis/truth-bear-verifiable-screening-intelligence-for-ai-agents-g.md) · [All operations](https://skmtc.dev/truthbear/apis/truth-bear-verifiable-screening-intelligence-for-ai-agents-g/llms.txt) · [OpenAPI document](https://skmtc.dev/truthbear/apis/truth-bear-verifiable-screening-intelligence-for-ai-agents-g/revisions/35744dfa4550?raw)