---
title: "List and search contacts"
method: GET
path: "/get-contacts/"
tags: ["Contacts"]
---

# List and search contacts

`GET /get-contacts/`

## Request

- Base URL: `http://api.smsfusion.com.au`
- URL: `http://api.smsfusion.com.au/get-contacts/`
- Auth: one of:
  - API key in query parameter `key`
  - HTTP basic

Cursor-paged contact listing. sort=desc reverses display order only; the since_id cursor always pages forward

## Query parameters

- `key` string, required
- `since_id` integer
- `listid` integer
- `msisdn` string
- `limit` integer
- `sort` 'asc' | 'desc'

## Response `200`

Successfull response

- ContactItem[]
  - `id` integer
  - `listid` integer
  - `created` integer: Unix timestamp
  - `msisdn` string
  - `country` string
  - `data` object: The contact's field values. Always a JSON object, {} when empty
  - `unsub` boolean
  - `lastclick` integer
  - `lastsend` integer

## Other responses

- `400`: QUERY_TOO_BROAD - an unfiltered cross-list scan exceeded the 3-second statement timeout; narrow with listid, msisdn, or a more recent since_id
- `401`: Authentication failed

---

[API](https://skmtc.dev/smsfusion/apis/sms-fusion-api.md) · [All operations](https://skmtc.dev/smsfusion/apis/sms-fusion-api/llms.txt) · [OpenAPI document](https://skmtc.dev/smsfusion/apis/sms-fusion-api/revisions/a88b2793a6e9?raw)