API reference
chevron_right
Contacts

List contacts

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

Retrieve a paginated list of contacts for a location, sorted by newest activity first. You can filter results by email, phone number, or other criteria. The response includes a cursor for pagination and the total count of matching contacts.

Parameters

location_idintegerRequiredquery
The location to work in. Must belong to your workspace.
emailstringquery
Filter contacts by email address.
phonestringquery
Filter contacts by phone number.
filtersstringquery
Additional filter criteria.
cursorstringquery
Pagination cursor from the previous response.

Responses

200

dataarray of string
next_cursorstring
totalinteger
at least 0

RequestcURL

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

Response200

{
  "data": [
    {
      "id": 18,
      "name": "Sam Rider",
      "first_name": "Sam",
      "last_name": "Rider",
      "email": "[email protected]",
      "phone_display": null,
      "interest": null,
      "source": null,
      "owner": null,
      "tags": [],
      "stage": null,
      "value_cents": 0,
      "last_activity_at": "2026-09-29T06:49:29.000000Z",
      "next_task": null,
      "dnd": false
    },
    {
      "id": 17,
      "name": "Unknown caller",
      "first_name": "Unknown caller",
      "last_name": "",
      "email": null,
      "phone_display": "(512) 555-1003",
      "interest": null,
      "source": null,
      "owner": null,
      "tags": [],
      "stage": null,
      "value_cents": 0,
      "last_activity_at": "2026-09-29T00:18:20.000000Z",
      "next_task": null,
      "dnd": false
    }
  ],
  "next_cursor": null,
  "total": 19
}