# GET /v2/payments
**Get payment history**

Returns confirmed payments received across all stores, ordered newest-first.

Authentication: Bearer token required (Authorization: Bearer YOUR_API_KEY)

## Query Parameters
- `limit` — integer, default: 200 (optional): Maximum number of payments to return (1–200). Defaults to 200.
- `timeframe` — string, enum("1W", "2W", "1M", "3M", "6M", "1Y"), default: "1M" (optional): Time window to filter payments. `1W` = 1 week, `2W` = 2 weeks, `1M` = 1 month, `3M` = 3 months, `6M` = 6 months, `1Y` = 1 year.
- `crypto` — string, enum("BTC", "BCH", "USDT") (optional): Filter by cryptocurrency. Omit to return all cryptocurrencies.
- `store_name` — string (optional): Partial case-insensitive store name filter.
- `currency` — string (optional): Fiat currency code (e.g. `USD`). When provided, each payment includes a `fiat_value` field with the historical fiat equivalent.

## Responses
- 200: List of payments
  - `data` (array)
- 400: Invalid parameter (limit out of range, unsupported crypto, or invalid timeframe)
- 401: Authentication required

Full reference: https://developers.blockonomics.co/docs/merchants/getpayments