Get touchpoints (call/message attempts) for a campaign. Touchpoints represent individual outreach attempts to contacts.

GET

https://host.com/v1/campaigns/:id/touchpoints

GET

/v1/campaigns/:id/touchpoints

1 const url = 'https://host.com/v1/campaigns/id/touchpoints';
2 const options = {
3   method: 'GET',
4   headers: {'X-API-Key': '<apiKey>', 'Content-Type': 'application/json'},
5   body: '{}'
6 };
7 
8 try {
9   const response = await fetch(url, options);
10   const data = await response.json();
11   console.log(data);
12 } catch (error) {
13   console.error(error);
14 }

200Retrieved

1 {
2   "data": [
3     {
4       "touchpointId": "string",
5       "contactId": "string",
6       "contactFirstName": "string",
7       "contactLastName": "string",
8       "phoneNumber": "string",
9       "externalId": "string",
10       "outreachId": "string",
11       "timezone": "string",
12       "type": "string",
13       "outcome": "string",
14       "publishedAt": "2024-01-15T09:30:00Z",
15       "finishedAt": "2024-01-15T09:30:00Z",
16       "duration": 1,
17       "transcript": [
18         {
19           "role": "string",
20           "content": "string",
21           "startMs": 1,
22           "endMs": 1
23         }
24       ],
25       "additionalData": {},
26       "errorMessage": "string",
27       "message": "string"
28     }
29   ],
30   "total": 1,
31   "page": 1,
32   "size": 1,
33   "pages": 1
34 }

Authentication

X-API-Keystring

API Key authentication. Generate your API key in the Gail Portal under General > Integrations > API Keys.

Path parameters

idstringRequiredformat: "uuid"

The unique identifier of the campaign.

Query parameters

includeTranscriptsbooleanOptionalDefaults to false

When true, includes call transcripts in the response.

afterstringOptionalformat: "uuid"

A GUID cursor to fetch items strictly after this ID.

beforestringOptionalformat: "uuid"

A GUID cursor to fetch items strictly before this ID.

limitintegerOptionalDefaults to 50

Maximum number of items to retrieve (default 50).

pageintegerOptionalDefaults to 1Deprecated

The page number (1-based).

sizeintegerOptionalDefaults to 50Deprecated

Number of items per page (default 50).

Request

Pagination parameters.

Response

datalist of objects or nullOptional

totalinteger or nullOptional

pageinteger or nullOptional

sizeinteger or nullOptional

pagesinteger or nullOptional