# Radio Station Queue Intent Status Poller

> Radio Station Queue Intent Status Poller is a paid API for AI agents from radio.withzero.xyz, paid per call via MPP, metered — billed by usage, status unknown (last checked 2026-09-13).

Returns recent queue intents for a station with their current status and outcome details, used to poll for results after a queue POST returns pending.

## Facts

- Endpoint: GET https://radio.withzero.xyz/api/v1/stations/{id}/queue
- Price: metered — billed by usage
- Payment: MPP
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Provider: radio.withzero.xyz
- Website: https://radio.withzero.xyz
- Canonical page: https://www.zero.xyz/c/radio-withzero-xyz-radio-station-queue-intent-status-poller-5f51879e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rbIYuE1fxpcL0v-fBkxFD

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability radio-withzero-xyz-radio-station-queue-intent-status-poller-5f51879e
```

Example prompt: Check the recent queue intents for my radio station (ID: station-abc123) and tell me whether my last submitted show has moved past pending — I need to see the outcome details like when it aired or if it failed.

## When to prefer this

Use this endpoint immediately after a queue POST returns status: pending, and continue polling it to detect when your intent transitions to consumed or failed. It is the correct endpoint for tracking the full lifecycle of a broadcast queue submission on radio.withzero.xyz, including timing data for transitions. Prefer this over any generic status endpoint when you need outcome details specific to station queue intents.

## Known failure modes

- Invalid or non-existent station ID returns an error or empty result
- Unauthorized access if the caller is not the station owner
- No intents returned if no queue activity has occurred recently
- Outcome fields remain null while status is still pending or draining
- Network timeout if the radio service is temporarily unavailable

## How this service works

Recent queue intents for your station with outcomes — poll after a queue POST returns status: pending.

## Output

Returns a JSON object containing the station ID and an array of recent queue intents, each with intentId, programId, title, createdAt, a status enum (pending, draining, consumed, failed), and an outcome object (set once consumed or failed) containing timing fields like airsAtMs, exitAtMs, enteredAtMs, transitionMs, a mixed flag, and an error string if applicable.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "id"
 ],
 "properties": {
  "id": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "station",
  "intents"
 ],
 "properties": {
  "intents": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "intentId",
     "programId",
     "title",
     "status",
     "createdAt",
     "outcome"
    ],
    "properties": {
     "title": {
      "anyOf": [
       {
        "type": "string"
       },
       {
        "type": "null"
       }
      ]
     },
     "status": {
      "enum": [
       "pending",
       "draining",
       "consumed",
       "failed"
      ],
      "type": "string"
     },
     "outcome": {
      "anyOf": [
       {
        "type": "object",
        "properties": {
         "error": {
          "type": "string"
         },
         "mixed": {
          "type": "boolean"
         },
         "airsAtMs": {
          "type": "number"
         },
         "exitAtMs": {
          "type": "number"
         },
         "enteredAtMs": {
          "type": "number"
         },
         "transitionMs": {
          "type": "number"
         }
        },
        "additionalProperties": false
       },
       {
        "type": "null"
       }
      ],
      "description": "Set once the intent is consumed or failed."
     },
     "intentId": {
      "type": "string"
     },
     "createdAt": {
      "type": "string"
     },
     "programId": {
      "type": "string"
     }
    },
    "additionalProperties": false
   }
  },
  "station": {
   "type": "string"
  }
 },
 "additionalProperties": false
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/radio-withzero-xyz-radio-station-queue-intent-status-poller-5f51879e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from radio.withzero.xyz](https://www.zero.xyz/host/radio.withzero.xyz/llms.txt)