> ## Documentation Index > Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt > Use this file to discover all available pages before exploring further. # Get All Contacts [Back to API List](/ai-for-service/apis/contact-center/api-list) # Get All Contacts API 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.](/ai-for-service/apis/automation/api-introduction#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 ``` 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 ``` { "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 |