Sign in
agentApiContacts

List contact 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.
get/api/v1/agent/contacts/requests

Query parameters

pageinteger

Page number

page_sizeinteger

Items per page per direction (max 100)

sent_status'pending' | 'approved' | 'rejected' | 'cancelled' | 'all'

Filter sent requests by status (default: pending)

Headers

X-API-Keystring required

Enter your API key for programmatic access

Response

Requests list

ContactsListAgentContactRequestsResponse200 required— unresolved $ref

Changes