# List gift card categories (/docs/api-reference/gift-cards/get-categories)

`GET /v1/giftcards/categories`

Lists the gift card categories with their display names.

Returns the complete list `{ items: [{ category, name }] }`, without paging. Use a `category` value to
filter search and the catalog. The route takes no query parameters.

## Responses

### 200

OK

- `text/plain`: `GiftCardCategoryList`
- `application/json`: `GiftCardCategoryList`
- `text/json`: `GiftCardCategoryList`

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 429

Too many requests from this IP address. Wait for Retry-After seconds, then send the same request again; an order keeps its Idempotency-Key and body.

- `application/json`: `ErrorResponse`

The full schemas are in the OpenAPI specification at /openapi.json.