TelefonAIv1
Contacts

List contacts, most recently changed first, or look one up by phone number

List contacts, most recently changed first, or look one up by phone number. Every contact has the same fields as the single lookup plus tags and updated_at. SYNCING: store the time of your last call, and next time fetch only what changed since with updated_since — combine with the contact.created, contact.updated and contact.deleted webhooks to know when it is worth asking. Deleted contacts are not in the list; you only get those as contact.deleted.

GET/v1/contacts

Authentication

Authorizationstringheaderrequired

Your API key as a Bearer token.

Parameters

limitintegerquery

Rows per page. 1–100, default 25.

offsetintegerquery

Rows to skip. Default 0.

phonestringquery

Danish number, any format. An unknown number returns an empty list, never a 404.

updated_sincestringquery

ISO 8601. Only contacts created or changed at or after this time. An invalid date gives 400.

tag_idstringquery

Only contacts with this tag. See GET /v1/contact-tags.

Request

curl --request GET \
  --url "https://api.telefonai.dk/v1/contacts" \
  --header "Authorization: Bearer $API_NOEGLE"

Response

application/json

Success.

object

401Missing key
{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key."
  }
}