Get what is outstanding

read

What is outstanding: times to report, weeks to sign, versions to acknowledge.

GEThttps://affiliates.radioworkflow.com/api/v1/affiliations/{id}/status

Read: this changes nothing.

One call for a dashboard or a nightly check: how many units still need a time, which weeks still need a signature and when each is due, which new versions the station has not acknowledged, and how many creatives are still waiting for audio.

nextDeadline is the earliest unsigned week's due time, when there is one. dueAt values are Unix seconds; due is the same instant written out in the station's time zone.

Authentication

Send a station key as Authorization: Bearer rwaff_k_.... A key with the read scope. Keys and scopes

Path parameters

idstring1 to 64 charactersrequired

The affiliation id from GET /v1/affiliations: one station's relationship with one network.

Response

200application/jsonThe station's clock, what is outstanding and the next deadline.

Response schema

nowNowrequired

outstandingobjectrequired

outstanding.to_reportintegerrequired

outstanding.to_signobject[]required

outstanding.to_sign[].weekdaterequired

outstanding.to_sign[].duestringrequired

outstanding.to_sign[].dueAtintegerrequired

outstanding.to_sign[].overduebooleanrequired

outstanding.to_acknowledgeobject[]required

outstanding.to_acknowledge[].weekdaterequired

outstanding.to_acknowledge[].versionintegerrequired

outstanding.audio_pendingintegerrequired

nextDeadlineobjectoptional

nextDeadline.weekdaterequired

nextDeadline.duestringrequired

nextDeadline.dueAtintegerrequired

Now4 fields

datedaterequired

minutesinteger (0 to 1439)required

tsintegerrequired

timezonestringrequired

Errors

403forbiddenThe key is valid but cannot do this for this affiliation: the affiliation is not one of the key's, or the person who made the key lacks the role.

502upstream_failedThe service behind the API answered in a way the portal could not use.

Possible on every endpoint

401invalid_principalThe key is missing, malformed, unknown, revoked or expired; all of these answer the same way.

429rate_limitedToo many requests: the key's bucket, a daily limit or the failed sign-in brake refused this one.

500server_errorSomething went wrong on our side. The answer never carries internal detail.

503unavailableThe service is not available right now: it could not be reached, or it is not set up yet.

Every code, its fix and when to retry

Rate limits

Failed sign-ins per address10 per minuteportal:auth

Burst per key60 per minuteportal:key

Calls per key600 per 10 minuteskey:{prefix}

The limits and the RateLimit headers

MCP

An assistant calls this as the tool get_status, with the same input as one object. The MCP server

Request

curl -X GET 'https://affiliates.radioworkflow.com/api/v1/affiliations/srn-ksmt/status' \
  -H "Authorization: Bearer $AFFILIATE_API_KEY"

Response200

{
  "now": {
    "date": "2026-09-24",
    "minutes": 630,
    "ts": 1790263800,
    "timezone": "America/Chicago"
  },
  "outstanding": {
    "to_report": 7,
    "to_sign": [
      {
        "week": "2026-09-21",
        "due": "Fri, Oct 2, 5:00 PM",
        "dueAt": 1790978400,
        "overdue": false
      }
    ],
    "to_acknowledge": [
      {
        "week": "2026-09-21",
        "version": 3
      }
    ],
    "audio_pending": 1
  },
  "nextDeadline": {
    "week": "2026-09-21",
    "due": "Fri, Oct 2, 5:00 PM",
    "dueAt": 1790978400
  }
}

Try it

Demo data, no key, nothing saved