Skip to main content

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.

Back to API List Use this API to fetch complete details of an existing voice campaign using the campaign ID.
MethodGET
Endpointhttps://{{host}}/campaign/api/v2/public/{{streamId}}/campaign/{{campaignId}}?accountId={{accountId}}
Content-Typeapplication/json
Authorizationauth: {{JWT}} See How to generate the JWT Token.
API ScopeCampaign Management

​
Path Parameters

ParameterDescriptionType
hostEnvironment URL, for example, https://platform.kore.aistring, required
streamIdBot ID or Stream ID. You can get it from the general settings page.string, required
campaignIdUnique ID of the campaign to be updated. For example: cd-ed19e3c7-3682-5e72-a839-af9e0711xxxxstring, required

​
Sample Request

curl --location 'https://{{host}}/campaign/api/v2/public/{{streamId}}/campaign/{{campaignId}}?accountId={{accountId}}' \
--header 'iid: st-0603182c-7ffb-53c3-b307-47ca14bxxxxx' \
--header 'accountId: 67777ce93e25326494exxxxx' \
--header 'auth: <token>'

​
Headers

HeaderDescriptionRequired/Optional
authJWT token for authentication.required
iidThe Application Id.required
accountIdThe Account Id.required

​
Sample Response

{
    "status": "success",
    "message": "Campaign Product Feedback Voice Campaign-3.41 retrieved successfully",
    "data": {
        "_id": "cd-9e14b72-88cc-4544-9a98-7aee9b7xxxxx",
        "name": "Product Feedback Voice Campaign-3.41",
        "lname": "product feedback voice campaign-3.41",
        "description": "This voice campaign collects quick feedback on recent purchases.",
        "dncLists": {
            "id": "cl-68b802a-2b99-4245-8eea-6d322a8xxxxx",
            "name": "DNC CL Dec 4"
        },
        "priority": "5",
        "dialingMode": "Agentless",
        "dialingStrategy": {
            "callerId": { "phoneNumber": "+148465xxxxx" },
            "callingHours": {
                "frequency": "WEEKLY",
                "timezone": "Asia/Kolkata",
                "days": [
                    { "start": "9:00 AM", "end": "6:00 PM", "day": "MO" },
                    { "start": "9:00 AM", "end": "6:00 PM", "day": "TU" },
                    { "start": "9:00 AM", "end": "6:00 PM", "day": "WE" },
                    { "start": "9:00 AM", "end": "6:00 PM", "day": "TH" },
                    { "start": "9:00 AM", "end": "6:00 PM", "day": "FR" }
                ]
            },
            "dialingOrder": "FIFO",
            "maxAttemptsPerRecord": 3,
            "defaultRetryPeriod": 10,
            "maxRingTime": 30,
            "useSystemMappings": false
        },
        "experienceFlow": "cf-ecfa3927-eabc-52c4-8373-8a0b75dxxxxx",
        "status": "Ready",
        "createdAt": "2025-12-08T05:29:38.298Z",
        "updatedAt": "2025-12-08T05:32:10.977Z",
        "schedule": {
            "isSchedulingEnabled": false,
            "isRecurrenceEnabled": false
        },
        "contactLists": ["CL Only 2020 Dec 4"]
    }
}

​
Response Parameters

ParameterDescriptionType
statusOverall status of the API response. Example: "success"string
messageResponse message indicating the result of the request.string
dataContains the campaign details.object
data._idUnique identifier of the campaign.string
data.nameCampaign name (title-cased).string
data.lnameLowercased campaign name.string
data.descriptionDetailed description of the campaign purpose and behavior.string
data.dncListsContains the contact lists added under the Do Not Call (DNC) list.object
data.dncLists.idUnique identifier of the contact list in the DNC list.string (UUID)
data.dncLists.nameThe name of the contact list included in the DNC list.string
data.statusCurrent status of the campaign. Example: "Ready"string
data.priorityPriority level assigned to the campaign.string
data.dialingStrategyConfiguration for dialing or communication strategy.object
data.dialingStrategy.callerId.phoneNumberPhone number used as the caller ID or sender ID.string
data.dialingStrategy.callingHoursCampaign’s operating schedule.object
data.dialingStrategy.callingHours.frequencyFrequency for running the campaign. Example: "WEEKLY"string
data.dialingStrategy.callingHours.timezoneTime zone for the calling hours.string
data.dialingStrategy.callingHours.daysDays and time range when the campaign is active.array of object
data.dialingStrategy.callingHours.days[].dayDay of the week when campaign runs. Example: "MO"string
data.dialingStrategy.callingHours.days[].startCampaign start time for the day. (HH:MM AM/PM)string
data.dialingStrategy.callingHours.days[].endCampaign end time for the day. (HH:MM AM/PM)string
data.experienceFlowAssociated experience flow ID used by the campaign.string
data.createdAtTimestamp when the campaign was created. (ISO 8601)string
data.updatedAtTimestamp when the campaign was last updated. (ISO 8601)string
data.scheduleScheduling configuration for the campaign.object
data.schedule.isSchedulingEnabledIndicates whether the campaign has a scheduled start.boolean
data.schedule.isRecurrenceEnabledIndicates whether recurrence is enabled.boolean
data.contactListsNames of contact lists associated with the campaign.array of string
data.formatFormat of the campaign configuration. Example: "advanced"string