API reference
chevron_right
Conversations

List conversations

GEThttps://howdybell.com/api/v1/conversations

Returns a paginated list of conversations for the specified location. You can filter by status, channel kind, assignee, or search by contact name and email. Results are ordered by the last message time in descending order.

Parameters

location_idintegerRequiredquery
The location to work in. Must belong to your workspace.
statusstringquery
Filter by conversation status.
kindstringquery
Filter by channel kind.
assignee_user_idintegerquery
Filter by assignee user ID.
searchstringquery
Search term to match against contact first name, last name, or email.
cursorstringquery
Pagination cursor for the next page.

Responses

200

dataarray of string
next_cursorstring

RequestcURL

curl -X GET "https://howdybell.com/api/v1/conversations?location_id=1" \
  -H "Authorization: Bearer $HOWDYBELL_TOKEN" \
  -H "Accept: application/json" \

Response200

{
  "data": [
    {
      "id": 21,
      "contact": {
        "id": 17,
        "name": "Unknown caller",
        "phone_display": "(512) 555-1003",
        "email": null
      },
      "kind": "call",
      "channel": {
        "id": 7,
        "name": "Phone calls"
      },
      "status": "open",
      "snoozed_until": null,
      "assignee": null,
      "preview": "Outbound call to (512) 555-1003 by Alex",
      "last_message_at": "2026-10-05T03:15:36.000000Z",
      "last_inbound_at": "2026-09-29T00:18:20.000000Z",
      "unread": true,
      "unread_count": 1,
      "subject": null,
      "possible_match": null
    },
    {
      "id": 20,
      "contact": {
        "id": 16,
        "name": "Unknown caller",
        "phone_display": "(512) 555-1002",
        "email": null
      },
      "kind": "call",
      "channel": {
        "id": 7,
        "name": "Phone calls"
      },
      "status": "open",
      "snoozed_until": null,
      "assignee": null,
      "preview": "Incoming call from (512) 555-1002 via Google Ads",
      "last_message_at": "2026-09-29T00:18:20.000000Z",
      "last_inbound_at": "2026-09-29T00:18:20.000000Z",
      "unread": true,
      "unread_count": 1,
      "subject": null,
      "possible_match": null
    }
  ],
  "next_cursor": null
}