API reference

Get a campaign

One campaign — its settings, status and aggregate counters.

GEThttps://nextgenpanel.cloudshope.com/api/v1/sms/campaigns/{id}

Returns a single campaign: name, status, template, sender, schedule time and the sent / delivered / failed / invalid counters. The per-recipient list is not included — use the report endpoint for that.

Authentication

Send Authorization: Bearer <token>. Any valid API token for the account works.

Path parameters

NameTypeRequiredDescription
idintegerYesCampaign id.

Request

curl https://nextgenpanel.cloudshope.com/api/v1/sms/campaigns/1207 \
  -H "Authorization: Bearer cs_live_9f2c…"

Response

{
  "id": 1207,
  "campaign_name": "Diwali offer",
  "sms_type": "text",
  "status": "Delivered",
  "template_id": 88,
  "sender_id": "CLDSHP",
  "count": 2,
  "message_credits": 1,
  "total_credits": 2,
  "schedule_time": null,
  "created_at": "2026-09-08T09:20:41.000Z",
  "updated_at": "2026-09-08T09:21:55.000Z"
}
200 — example response

Errors

StatusTypeWhen
404not-foundNo campaign with this id on the account.
401unauthorizedThe Authorization header is missing, malformed or the token is invalid or expired.
403forbiddenThe token is valid but the account is not allowed to perform this action.