Get Current Send Plan
GET/api/send-plans/current
Get the latest ready working plan, plus the working plan currently calculating (if any). Use this as the entry point: plan is what to act on, calculating tells you a newer plan is on the way.
send-plans:readGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Bearer Personal Access Token with the send-plans:read scope. The token's user also needs permission to view the send planner.
Either key is null when there is no such plan. next_scheduled_run_at is when the next weekly send run starts (ISO 8601, UTC), or null when no weekly run is scheduled.
Request
Responses
- 200
- 401
- 403
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.