Skip to main content

Endpoint

POST https://api.apifycloud.io/api/v1/analytics/{appId}/messages/search

Authentication

Bearer token required. Scope: messages:read

Path parameters

  • appId (UUID, required)

Request body

  • limit (number, optional)
  • cursor (string, optional)
  • status (string, optional)
  • direction (string, optional) e.g. inbound, outbound
  • channel (string, optional)
  • messageType (string, optional)
  • source (string, optional)
  • destination (string, optional)
  • search (string, optional) matches user_phone, provider_message_id, conversation_key, provider_from, provider_to
  • startDate (string, optional) ISO date (YYYY-MM-DD)
  • endDate (string, optional) ISO date (YYYY-MM-DD)

Response

Errors

  • 400 invalid_request invalid JSON body
  • 403 forbidden unauthorized for app or missing scope
  • 400 validation_error invalid request parameters
  • 429 rate_limit_exceeded
  • 500 server_error

Example