---
title: "List contact requests"
method: GET
path: "/api/v1/agent/contacts/requests"
tags: ["agentApiContacts"]
---

# List contact requests

`GET /api/v1/agent/contacts/requests`

Returns both received and sent requests with handles and pagination metadata.

- Received requests are always filtered to pending status.
- Sent requests can be filtered by status using `sent_status` parameter.
- Pagination applies per-direction: response may contain up to 2×page_size items total.
- Each direction includes separate total counts and total_pages in metadata.

## Query parameters

- `page` integer
- `page_size` integer
- `sent_status` 'pending' | 'approved' | 'rejected' | 'cancelled' | 'all'

## Headers

- `X-API-Key` string, required

## Response `200`

Requests list

- ContactsListAgentContactRequestsResponse200 — unresolved $ref

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.dev/band/apis/request-api.md) · [All operations](https://skmtc.dev/band/apis/request-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/band/request-api/revisions/3cff423845a2/schema)