# List contacts

`GET /api/contacts/paginated`  (operationId: `listContacts`, group: Contacts)

Contacts, newest activity first, with pagination. Each contact has phone, name, email, company, status (New by default), tags (one comma-separated string), notes, chat_status, custom_attributes (an object), last_msg_time, claimed_by and claimed_by_name, plus the columns the app shows. search matches name, phone, tags and message text. For an API key this is part of the full API (Scale plan).

Part of the full API, which is included in the Scale plan. Any one of these scopes is enough: `contacts`, `contacts:read`.

**Parameters**

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `page` | query | integer | no | Page number from 1. Default 1. |
| `limit` | query | integer | no | Page size. Default 50. Default 50. |
| `search` | query | string | no | Search name, phone, tags and message text. |

**Response 200**: A page of contacts.

Example:

```json
{
  "success": true,
  "contacts": [
    {
      "phone": "919876543210",
      "name": "Ravi Kumar",
      "email": "ravi@example.com",
      "company": "Kumar Hosting",
      "status": "New",
      "tags": "vip,hosting",
      "chat_status": "open",
      "custom_attributes": {
        "plan": "Business"
      },
      "last_msg_time": "2026-10-02T09:06:40.000Z"
    }
  ],
  "meta": {
    "total": 14970,
    "page": 1,
    "limit": 50,
    "hasMore": true
  }
}
```

Part of the InboxWA API reference: https://inboxwa.online/docs/api . Full reference as one document: https://inboxwa.online/docs/api.md . OpenAPI: https://inboxwa.online/openapi.json