# List contacts (plain array)

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

Contacts as a plain JSON array rather than a page object, with an optional search and limit. Use List contacts for anything large.

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 |
| --- | --- | --- | --- | --- |
| `search` | query | string | no | Search name, phone and tags. |
| `limit` | query | integer | no | Maximum contacts to return. |

**Response 200**: A JSON array of contacts.

Example:

```json
[
  {
    "phone": "919876543210",
    "name": "Ravi Kumar",
    "status": "New",
    "tags": "vip,hosting"
  }
]
```

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