API ReferenceCampaignsGet follow-up status
GET/v1/campaigns/:id/followup-status

Get follow-up status

Per-lead progress through a campaign's follow-up sequence — which steps each lead has completed, skipped, or is waiting on.

Stablescope: read API KeyLearn about API scopes →

Request

AuthorizationBearer YOUR_API_KEY

Parameters

FieldTypeRequiredDescription
idstringRequiredCampaign ID.
curl "https://api.stynar.com/v1/campaigns/cmp_abc123/followup-status" \
  -H "Authorization: Bearer esk_your_key_here"

Response

200 OK
200 response
{
  "followupStatus": {
    "lead_1a2b3c": {
      "completedNodeIds": [
        "node_1"
      ],
      "skippedNodeIds": [],
      "failedNodeIds": [],
      "pendingNodeId": "node_2",
      "nextScheduledAt": "2026-08-18T09:00:00Z"
    }
  }
}

Response fields

Errors

StatusCodeMeaning
401 UnauthorizedUNAUTHORIZEDMissing, malformed, unknown, revoked, or expired key.
403 ForbiddenAPI_ACCESS_DISABLEDYour account doesn't currently have API access.
403 ForbiddenINSUFFICIENT_SCOPEThe key doesn't have the scope this endpoint requires.
404 Not FoundNOT_FOUNDUnknown route, or a resource that doesn't exist / isn't yours.
409 ConflictCONFLICTThe action can't be applied to the resource's current state.
429 Too Many RequestsRATE_LIMIT_EXCEEDEDPer-minute or per-second limit hit.
429 Too Many RequestsQUOTA_EXCEEDEDMonthly quota exhausted.
500 Internal Server ErrorINTERNAL_ERRORSomething broke on Stynar's end.
Full error reference →