List Messages

List Messages

get

Retrieve all messages for the authenticated user. Supports filtering by origin, delivery status, and date range.

Authorizations

AuthorizationstringRequired

Answering Service Care uses bearer token authentication. Generate API tokens from your user profile under Application Keys.

Query parameters

originstring · enumOptional

Filter messages by origin channel. Matching is case-insensitive.

Possible values:

statusstring · enumOptional

Filter messages by status.

Possible values:

from_datestringOptional

Start of date range in MM-DD-YYYY format (e.g. 01-01-2025).

Example: 01-01-2025Pattern: ^[0-1][0-9]-[0-3][0-9]-[0-9]{4}$

to_datestringOptional

End of date range in MM-DD-YYYY format (e.g. 01-31-2025).

Example: 01-31-2025Pattern: ^[0-1][0-9]-[0-3][0-9]-[0-9]{4}$

page_sizeinteger · min: 1 · max: 200Optional

Maximum number of results per page (default 50).

Default: 50

Responses

200

Successful response

application/json

401

Missing or invalid bearer token.

application/json

get/api/v2/messages

GET /api/v2/messages HTTP/1.1
Host: secure.answeringservicecare.com
Authorization: Bearer YOUR_API_TOKEN
Accept: */*

{
  "data": [
    {
      "id": 939,
      "read": true,
      "phone_number": "text",
      "extension": "text",
      "caller_id": "9548326297",
      "first_name": "text",
      "last_name": "text",
      "company_name": "text",
      "content": "This is a test message",
      "status": "delivered",
      "account_id": 4,
      "agent_id": 3,
      "user_id": 1,
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z",
      "ivr": "text",
      "pickup_date": "2026-01-01T00:00:00.000Z",
      "pickup_user_id": 1,
      "contact_id": 541,
      "delivered_at": "2026-01-01T00:00:00.000Z",
      "delivered_by": 3,
      "delivered_to": 1,
      "phone": "text",
      "email": "text",
      "call_ref_id": "text",
      "sale_id": 1,
      "note": "text",
      "did_id": 5,
      "address": "text",
      "address2": "text",
      "city": "text",
      "state": "text",
      "zip": "text",
      "how_you_hear_about_us": "text",
      "is_emergency": true,
      "alt_phone": "text",
      "positive_data_dip": true,
      "answers": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "escalation_level_id": 7,
      "next_escalation_at": "2026-01-01T00:00:00.000Z",
      "receiver_name": "John Doe",
      "non_message_type": "hang_up",
      "activities_count": 6,
      "closing_action_group_id": 1,
      "email_subject": "text",
      "escalation_counter": 0,
      "origin": "CALL",
      "message_received_date": "2026-01-01T00:00:00.000Z",
      "disposition": "text",
      "call_id": 1,
      "chat_session_id": 1,
      "to_do_task_id": 1,
      "from_to_do": false,
      "send_at": "2026-01-01T00:00:00.000Z",
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "klass_names": "text"
    }
  ]
}

List Recent Messages

get

Retrieve the most recent messages for the authenticated user.

Authorizations

AuthorizationstringRequired

Answering Service Care uses bearer token authentication. Generate API tokens from your user profile under Application Keys.

Responses

200

Successful response

application/json

401

Missing or invalid bearer token.

application/json

get/api/v2/messages/recents

GET /api/v2/messages/recents HTTP/1.1
Host: secure.answeringservicecare.com
Authorization: Bearer YOUR_API_TOKEN
Accept: */*

{
  "data": [
    {
      "id": 939,
      "read": true,
      "phone_number": "text",
      "extension": "text",
      "caller_id": "9548326297",
      "first_name": "text",
      "last_name": "text",
      "company_name": "text",
      "content": "This is a test message",
      "status": "delivered",
      "account_id": 4,
      "agent_id": 3,
      "user_id": 1,
      "created_at": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z",
      "ivr": "text",
      "pickup_date": "2026-01-01T00:00:00.000Z",
      "pickup_user_id": 1,
      "contact_id": 541,
      "delivered_at": "2026-01-01T00:00:00.000Z",
      "delivered_by": 3,
      "delivered_to": 1,
      "phone": "text",
      "email": "text",
      "call_ref_id": "text",
      "sale_id": 1,
      "note": "text",
      "did_id": 5,
      "address": "text",
      "address2": "text",
      "city": "text",
      "state": "text",
      "zip": "text",
      "how_you_hear_about_us": "text",
      "is_emergency": true,
      "alt_phone": "text",
      "positive_data_dip": true,
      "answers": {
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "escalation_level_id": 7,
      "next_escalation_at": "2026-01-01T00:00:00.000Z",
      "receiver_name": "John Doe",
      "non_message_type": "hang_up",
      "activities_count": 6,
      "closing_action_group_id": 1,
      "email_subject": "text",
      "escalation_counter": 0,
      "origin": "CALL",
      "message_received_date": "2026-01-01T00:00:00.000Z",
      "disposition": "text",
      "call_id": 1,
      "chat_session_id": 1,
      "to_do_task_id": 1,
      "from_to_do": false,
      "send_at": "2026-01-01T00:00:00.000Z",
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "klass_names": "text"
    }
  ]
}