List weeks

read

Published weeks for this station.

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

Read: this changes nothing.

The weeks the network has published for this station, newest first, at most 26 (about six months): each week's latest version, state, deadline and how many units have been reported. There is no paging: older weeks stay readable by their Monday with get-week.

state moves from published to in_progress as times come in, to ready_to_sign once the broadcast week has ended and nothing is pending, and to signed.

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/jsonUp to 26 weeks, newest first.

Response schema

weeksWeekSummary[]required

WeekSummary10 fields

startdaterequired

versionintegerrequired

state"signed" | "ready_to_sign" | "in_progress" | "published"required

duestringrequired

dueAtintegerrequired

publishedAtstringrequired

publishedAtTsintegerrequired

unitsTotalintegerrequired

unitsReportedintegerrequired

signedbooleanrequired

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 list_weeks, with the same input as one object. The MCP server

Request

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

Response200

{
  "weeks": [
    {
      "start": "2026-09-21",
      "version": 3,
      "state": "in_progress",
      "due": "Fri, Oct 2, 5:00 PM",
      "dueAt": 1790978400,
      "publishedAt": "Thu, Sep 24, 9:12 AM",
      "publishedAtTs": 1790259120,
      "unitsTotal": 9,
      "unitsReported": 2,
      "signed": false
    }
  ]
}

Try it

Demo data, no key, nothing saved