> ## Documentation Index > Fetch the complete documentation index at: https://docs.rivi.software/llms.txt > Use this file to discover all available pages before exploring further. # Get public media > Fetch published media bytes anonymously. The id is the published version UUID, not the asset ID. Only published media can be delivered. A single Range header can request part of the file; 206 returns bytes, not JSON. Example: `Range: bytes=0-1023`. Do not parse this response as JSON or store it in a shared cache. ## OpenAPI ````yaml /radiotools/openapi.json get /api/media/public/{stationId}/{id} openapi: 3.1.0 info: title: RadioTools API version: 1.0.0 description: >- RadioTools APIs for listener websites and apps, published media, and now-playing metadata ingestion. servers: - url: https://radiotools.rivi.software description: radiotools API security: [] tags: - name: Public listener description: >- Tenant-token published delivery (listener:read; push:register for device changes). Published media remains anonymous. OPTIONS allows every origin; JSON is no-store with a strong ETag for conditional polling. - name: Ingest description: >- Automation credentials. The credential resolves the station; payloads cannot change it. paths: /api/media/public/{stationId}/{id}: get: tags: - Public listener summary: >- Read authorized immutable bytes; supports a single Range, never shared-cacheable description: >- Fetch published media bytes anonymously. The id is the published version UUID, not the asset ID. Only published media can be delivered. A single Range header can request part of the file; 206 returns bytes, not JSON. Example: `Range: bytes=0-1023`. Do not parse this response as JSON or store it in a shared cache. parameters: - schema: type: string required: true name: stationId in: path description: >- Station ID associated with your credential. Send this or stationSlug, not both. example: station-rivier - schema: type: string format: uuid required: true name: id in: path description: Published media version UUID from the record's media list. example: a6286c77-6253-433b-80e9-38aed5d72a60 responses: '200': description: Media bytes content: application/octet-stream: schema: type: string format: binary '206': description: >- Partial media bytes for one satisfiable Range request. Read Content-Range for the returned byte interval and total size; there is no JSON body. '400': description: The request contains invalid parameters or input. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: >- Human-readable explanation; branch on the stable error code instead of this text. example: The request contains invalid parameters or input. requestId: type: string format: uuid description: >- Request trace identifier. Include this value or the x-request-id header when reporting an issue. example: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 required: - message - requestId description: >- Error details. Listener errors are structured; playback ingest uses a legacy error string. example: code: VALIDATION_ERROR message: The request contains invalid parameters or input. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 issues: - path: query message: >- Check the parameter types and bounds documented for this operation. required: - error example: error: code: VALIDATION_ERROR message: The request contains invalid parameters or input. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 issues: - path: query message: >- Check the parameter types and bounds documented for this operation. examples: error: summary: 400 VALIDATION_ERROR value: error: code: VALIDATION_ERROR message: The request contains invalid parameters or input. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 issues: - path: query message: >- Check the parameter types and bounds documented for this operation. '401': description: A valid station credential with the required scope is needed. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: >- Human-readable explanation; branch on the stable error code instead of this text. example: >- A valid station credential with the required scope is needed. requestId: type: string format: uuid description: >- Request trace identifier. Include this value or the x-request-id header when reporting an issue. example: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 required: - message - requestId description: >- Error details. Listener errors are structured; playback ingest uses a legacy error string. example: code: UNAUTHENTICATED message: >- A valid station credential with the required scope is needed. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 required: - error example: error: code: UNAUTHENTICATED message: >- A valid station credential with the required scope is needed. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 examples: error: summary: 401 UNAUTHENTICATED value: error: code: UNAUTHENTICATED message: >- A valid station credential with the required scope is needed. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 '403': description: The credential does not permit this operation. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: >- Human-readable explanation; branch on the stable error code instead of this text. example: The credential does not permit this operation. requestId: type: string format: uuid description: >- Request trace identifier. Include this value or the x-request-id header when reporting an issue. example: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 required: - message - requestId description: >- Error details. Listener errors are structured; playback ingest uses a legacy error string. example: code: FORBIDDEN message: The credential does not permit this operation. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 required: - error example: error: code: FORBIDDEN message: The credential does not permit this operation. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 examples: error: summary: 403 FORBIDDEN value: error: code: FORBIDDEN message: The credential does not permit this operation. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 '404': description: >- The resource is missing, unpublished, disabled, or unavailable for this station. A switched-off station module returns MODULE_DISABLED. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: >- Human-readable explanation; branch on the stable error code instead of this text. example: >- The resource is missing, unpublished, disabled, or unavailable for this station. A switched-off station module returns MODULE_DISABLED. requestId: type: string format: uuid description: >- Request trace identifier. Include this value or the x-request-id header when reporting an issue. example: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 required: - message - requestId description: >- Error details. Listener errors are structured; playback ingest uses a legacy error string. example: code: NOT_FOUND message: >- The resource is missing, unpublished, disabled, or unavailable for this station. A switched-off station module returns MODULE_DISABLED. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 required: - error example: error: code: NOT_FOUND message: >- The resource is missing, unpublished, disabled, or unavailable for this station. A switched-off station module returns MODULE_DISABLED. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 examples: error: summary: 404 NOT_FOUND value: error: code: NOT_FOUND message: >- The resource is missing, unpublished, disabled, or unavailable for this station. A switched-off station module returns MODULE_DISABLED. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 '409': description: The request conflicts with the current resource revision. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: >- Human-readable explanation; branch on the stable error code instead of this text. example: >- The request conflicts with the current resource revision. requestId: type: string format: uuid description: >- Request trace identifier. Include this value or the x-request-id header when reporting an issue. example: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 required: - message - requestId description: >- Error details. Listener errors are structured; playback ingest uses a legacy error string. example: code: REVISION_CONFLICT message: >- The request conflicts with the current resource revision. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 required: - error example: error: code: REVISION_CONFLICT message: The request conflicts with the current resource revision. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 examples: error: summary: 409 REVISION_CONFLICT value: error: code: REVISION_CONFLICT message: >- The request conflicts with the current resource revision. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 '413': description: Media request denied or unavailable content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: >- Human-readable explanation; branch on the stable error code instead of this text. requestId: type: string format: uuid description: >- Request trace identifier. Include this value or the x-request-id header when reporting an issue. required: - message - requestId description: >- Error details. Listener errors are structured; playback ingest uses a legacy error string. required: - error '429': description: Too many requests. Reduce the request frequency. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: >- Human-readable explanation; branch on the stable error code instead of this text. example: Too many requests. Reduce the request frequency. requestId: type: string format: uuid description: >- Request trace identifier. Include this value or the x-request-id header when reporting an issue. example: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 required: - message - requestId description: >- Error details. Listener errors are structured; playback ingest uses a legacy error string. example: code: RATE_LIMITED message: Too many requests. Reduce the request frequency. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 required: - error example: error: code: RATE_LIMITED message: Too many requests. Reduce the request frequency. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 examples: error: summary: 429 RATE_LIMITED value: error: code: RATE_LIMITED message: Too many requests. Reduce the request frequency. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 '503': description: An upstream service is temporarily unavailable. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: >- Human-readable explanation; branch on the stable error code instead of this text. example: An upstream service is temporarily unavailable. requestId: type: string format: uuid description: >- Request trace identifier. Include this value or the x-request-id header when reporting an issue. example: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 required: - message - requestId description: >- Error details. Listener errors are structured; playback ingest uses a legacy error string. example: code: PROVIDER_UNAVAILABLE message: An upstream service is temporarily unavailable. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 required: - error example: error: code: PROVIDER_UNAVAILABLE message: An upstream service is temporarily unavailable. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 examples: error: summary: 503 PROVIDER_UNAVAILABLE value: error: code: PROVIDER_UNAVAILABLE message: An upstream service is temporarily unavailable. requestId: 28e5d867-1f87-4ca7-bca9-4ebc09b36ba3 security: [] ```` ## Related topics - [Get public media variant](/radiotools/api-reference/public-listener/get-public-media-variant.md) - [Public delivery](/radiotools/api-reference/public-delivery.md) - [GraphQL schema reference](/radiotools/api-reference/graphql-reference.md) - [Get content record](/radiotools/api-reference/public-listener/get-content-record.md) - [Get content record by slug](/radiotools/api-reference/public-listener/get-content-record-by-slug.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.