> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Get All Contacts

[Back to API List](https://koreai.mintlify.site/ai-for-service/apis/contact-center/api-list)

Use this API to retrieve all contacts created for outbound calling in a given stream ID.

| Method | GET |
| :- | :- |
| **Endpoint** | `https://{{host}}/agentassist/api/v1/public/{{streamId}}/contacts` |
| **Content Type** | `application/json` |
| **Authorization** | `auth: {{JWT}}` See [How to generate the JWT Token.](https://koreai.mintlify.site/ai-for-service/apis/automation/api-introduction.md#generating-the-jwt-token) |
| **API Scope** | Configuration |

## Path Parameters

| Parameter | Description | Type |
| :- | :- | :- |
| `host` | Environment URL, for example, `https://platform.kore.ai` | string, required |
| `streamId` | BotId or StreamId. You can access it from the App Settings page of the bot. | string, required |

## Sample Request

```bash theme={null}
curl --location 'https://{{host}}/agentassist/api/v1/public/{{streamId}}/contacts' \
--header 'Content-Type: application/json' \
--header 'accountId: {{accountId}}' \
--header 'auth: {{jwt_token}}'
```

## Request Headers

| Header | Description | Required/Optional |
| :- | :- | :- |
| `auth` | JWT token for authentication. | required |
| `accountId` | The account ID associated with the API request. | required |
| `Content-Type` | The format in which the request payload is sent to the server. Example: `application/json` | required |

## Sample Response

```json expandable=true theme={null}
{
    "results": [
        {
            "firstName": "john",
            "lastName": "doe",
            "fullName": "john doe",
            "salutation": "mr",
            "cellPhone": {
                "extension": "+91",
                "phoneNumber": "+9195501xxxxx",
                "countryCode": "+91"
            },
            "status": "ACTIVE",
            "instanceBotId": "st-7dc994f0-4436-5134-9fa8-a942625xxxxx",
            "orgId": "o-16ff21d2-5d27-5fb2-b9bd-9fedb5fxxxxx",
            "accountId": "65f7d49a5dd06e2cefaxxxxx",
            "createdBy": "u-cc6ebd6c-656c-5364-abfc-ad5f80exxxxx",
            "createdByAId": "a-6c63a33-c2a7-49e8-a5ab-82449c8xxxxx",
            "address": [],
            "twitterDetails": [],
            "createdAt": "2024-06-28T05:24:07.218Z",
            "updatedAt": "2026-01-05T09:16:34.633Z",
            "updatedBy": "u-cc6ebd6c-656c-5364-abfc-ad5f80exxxxx",
            "updatedByAId": "a-6c63a33-c2a7-49e8-a5ab-82449c8xxxxx",
            "id": "667e48f7c8b972fc691xxxxx"
        },
        {
            "firstName": "john",
            "lastName": "doe_1",
            "fullName": "john doe_1",
            "salutation": "mr",
            "cellPhone": {
                "extension": "+",
                "phoneNumber": "+9124456xxxxx",
                "countryCode": "+91"
            },
            "status": "ACTIVE",
            "instanceBotId": "st-7dc994f0-4436-5134-9fa8-a942625xxxxx",
            "orgId": "o-16ff21d2-5d27-5fb2-b9bd-9fedb5fxxxxx",
            "accountId": "65f7d49a5dd06e2cefaxxxxx",
            "createdBy": "u-cc6ebd6c-656c-5364-abfc-ad5f80exxxxx",
            "createdByAId": "a-6c63a33-c2a7-49e8-a5ab-82449c8xxxxx",
            "address": [],
            "twitterDetails": [],
            "createdAt": "2026-01-07T09:46:35.399Z",
            "updatedAt": "2026-01-07T09:46:35.399Z",
            "id": "695e2b7b786560d6a90xxxxx"
        }
    ],
    "skip": 0,
    "limit": 10,
    "hasMore": false,
    "totalPages": 1,
    "totalResults": 6
}
```

## Response parameters

| Parameter | Description | Type |
| :- | :- | :- |
| `firstName` | Contact's first name. | string |
| `lastName` | Contact's last name. | string |
| `fullName` | Contact's full name. | string |
| `salutation` | Salutation or title of the contact. | string |
| `cellPhone` | Mobile details of the contact. | object |
| `cellPhone.extension` | Dialing prefix | string |
| `cellPhone.phoneNumber` | Contact’s mobile phone number. | string |
| `cellPhone.countryCode` | Country calling code associated with the phone number. | string |
| `status` | Current status of the contact | string |
| `instanceBotId` | Unique identifier of the associated bot instance. | string |
| `orgId` | Unique identifier of the organization. | string |
| `accountId` | Unique identifier of the account. | string |
| `createdBy` | Unique identifier of the user who created the contact. | string |
| `createdByAId` | Unique identifier of the application that created the record. | string |
| `address` | List of addresses associated with the contact. | array of objects |
| `twitterDetails` | List of Twitter profile details associated with the contact. | array of objects |
| `createdAt` | Timestamp indicating when the contact was created. | string (ISO 8601 Date-Time) |
| `updatedAt` | Timestamp indicating when the contact was last updated. | string (ISO 8601 Date-Time) |
| `updatedBy` | Unique identifier of the user who last updated the contact. | string |
| `updatedByAId` | Unique identifier of the application that updated the contact. | string |
| `id` | Unique identifier of the contact record. | string |
| `skip` | Number of records to skip before starting to return results | integer |
| `limit` | Maximum number of records returned in a single request | integer |
| `hasMore` | Indicates whether more records are available beyond the current result set. | boolean |
| `totalPages` | Total number of available pages based on the current limit. | integer |
| `totalResults` | Total number of records available across all pages. | integer |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.