---
search:
  tags:
    - Agent
    - GET
seo:
  description: >-
    Agent token required in live mode (merchant keys are whitelisted for this
    path but… Reference for the GET /v1/catalog endpoint in the agentsub Gateway
    API.
sidebar:
  label: Offer catalog
  badge: GET
title: Offer catalog
type: openapi-operation
---
Agent token required in live mode (merchant keys are whitelisted for this path but the handler still requires an agent identity). `q` filters by title/description substring. With `Accept: text/plain` returns a plain-text listing instead.

`GET /v1/catalog`

**Responses**

- `200` — Matching offers
- `401` — \`unauthorized\` problem; live 401s advertise \`WWW-Authenticate: Bearer resource\_metadata=...\`
- `503` — Runtime or provider configuration unavailable (\`runtime\_configuration\_required\`, \`signing\_configuration\_required\`, \`runtime\_unavailable\`, \`workspace\_unavailable\`, \`provider\_configuration\_required\`)

Response example, 200:

```json
{
  "offers": [
    {
      "id": "string",
      "acceptorId": "string",
      "title": "string",
      "description": "string",
      "unit": "string",
      "priceUc": "string",
      "priceUsd": "string",
      "category": "string",
      "acceptedPaymentMethods": [
        "string"
      ]
    }
  ]
}
```