1MSG
ReferenceCampaigns API

Analytics summary

GET
/api/v1/campaigns/{campaignId}/analytics

Counts for the snapshot taken at send. dailyLimit is the channel tier, not a campaign setting. Rates are fractions from 0 to 1.

Authorization

bearer
headerAuthorizationBearer <token>

Key issued in Settings → Developer → API key. Inbox methods need the Inbox scope. Campaigns methods need the Campaigns scope.

Path Parameters

campaignId*string

Campaign id returned by create or list.

Response Body

application/json
  1. response
campaignId*string

Campaign id.

status*string

Campaign status.

Value in"draft""sending""pause""completed""failed""scheduled"
recipients*number

Recipients in the send snapshot.

sent*number

Recipients whose status is sent, delivered, or read.

delivered*number

Recipients whose status is delivered or read.

read*number

Recipients whose status is read.

failed*number

Recipients whose status is failed.

skipped*number

Recipients whose status is skipped.

cancelled*number

Recipients removed from the queue before send.

queued*number

Recipients whose status is queued or leasing.

replied*number

Recipients who sent at least one reply.

textReplies*number

Recipients who sent at least one text reply.

clicks*number

Button replies in the snapshot.

uniqueClicks*number

Recipients who clicked at least one button.

rates*

Shares of recipients, from 0 to 1, rounded to 4 decimal places. Each rate is 0 when there are no recipients.

buttons*array<>

Button clicks grouped by button id.

queuedRemaining*number

Recipients still waiting to be sent.

sentThisPortion*number

Template sends already started in the current tier window.

dailyLimit*|

How many template sends this channel may start in a rolling 24 hours, or null when the tier is unknown or unlimited.

nextPortionAt*|

When the next template portion can start, or null when a portion is not waiting.

Formatdate-time
curl -X GET 'https://api.1msg.io/api/v1/campaigns/string/analytics'
{  "campaignId": "cm3campaign01",  "status": "draft",  "recipients": 12,  "sent": 10,  "delivered": 8,  "read": 4,  "failed": 1,  "skipped": 1,  "cancelled": 0,  "queued": 0,  "replied": 2,  "textReplies": 1,  "clicks": 3,  "uniqueClicks": 2,  "rates": {    "sent": 0.5,    "delivery": 0.4,    "read": 0.25,    "reply": 0.1,    "click": 0.05,    "failed": 0  },  "buttons": [    {      "id": "shop",      "title": "Shop",      "clicks": 4,      "uniqueClicks": 3    }  ],  "queuedRemaining": 0,  "sentThisPortion": 0,  "dailyLimit": 1000,  "nextPortionAt": null}