Contacts

List contacts

GET/contactsScope contacts:read

Returns your contacts, newest first, a page at a time.

Query parameters

searchstring
Matches name, phone or email.
tagstring
Only contacts with this tag.
statusstring
Contact status.
One of: active, opted_out, invalid
consentStatusstring
Marketing consent.
One of: unverified, opted_in, opted_out
pageinteger
Page number, from 1. Defaults to 1.
limitinteger
Per page, up to 100. Defaults to 25.

Good to know

status is invalid when WhatsApp has refused the number (not on WhatsApp, or it blocked you).

Errors

Plus the errors any endpoint can return, such as a missing key or scope. See Errors.

Request

# macOS, Linux or Git Bash, with WAMAFY_API_KEY set. The quoting does not work in Windows cmd or PowerShell.
curl "https://api.wamafy.com/api/v1/public/contacts?tag=vip&limit=50" \
  -H "Authorization: Bearer $WAMAFY_API_KEY"

Response 200

{
  "success": true,
  "data": [
    {
      "id": "9d3f6b2a-4e1c-4a8b-9f0d-2c7e5a1b3d64",
      "phone": "919876543210",
      "name": "Priya Sharma",
      "firstName": "Priya",
      "lastName": "Sharma",
      "company": "Acme Retail",
      "language": "en",
      "email": "priya@example.com",
      "tags": [
        "vip"
      ],
      "status": "active",
      "consentStatus": "opted_in",
      "source": "api",
      "customFields": {
        "city": "Mumbai"
      },
      "createdAt": "2026-09-02T08:15:00.000Z",
      "updatedAt": "2026-10-07T10:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1,
    "pageCount": 1
  }
}

Base URL https://api.wamafy.com/api/v1/public