# list contacts

`GET https://api.suger.cloud/org/{orgId}/contact`

List all contacts under the given organization. If contactIds parameter is provided, return only those specific contacts.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `orgId` | path | string | yes | Organization ID |
| `contactIds` | query | string | no | Comma-separated list of contact IDs to fetch specific contacts, up to 100 IDs |
| `emailDomain` | query | string | no | Email domain to filter contacts |
| `keyword` | query | string | no | keyword to search contacts by name or email |
| `limit` | query | integer | no | List pagination size, default 1000, max value is 1000 (ignored when contactIds is provided) |
| `offset` | query | integer | no | List pagination offset, default 0 (ignored when contactIds is provided) |

## Responses

### 200 — OK

Content-Type: `application/json`

### 400 — Bad request error description

Content-Type: `application/json`

### 500 — internal error description

Content-Type: `application/json`

---

Interactive API reference: https://doc.suger.io/api/