> ## Documentation Index > Fetch the complete documentation index at: https://docs.member.dev/llms.txt > Use this file to discover all available pages before exploring further. # List Public Playlist Files ## OpenAPI ````yaml /openapi/mio-openapi.json get /api/v1/playlist/{playlist_id}/files openapi: 3.1.0 info: description: >- Production API reference for Membership.io. Use the authored guides for workflows and the generated endpoint pages for exact parameters and schemas. title: Membership.io API version: 0.1.0 servers: - description: Production url: https://api.member.dev security: - bearerAuth: [] paths: /api/v1/playlist/{playlist_id}/files: get: tags: - media-public summary: List Public Playlist Files operationId: media_public.get_media_public_get_playlist_by_playlist_id_files parameters: - in: path name: playlist_id required: true schema: title: Playlist Id type: string - in: query name: hub_id required: false schema: anyOf: - type: string - type: 'null' title: Hub Id responses: '200': content: application/vnd.api+json: schema: $ref: '#/components/schemas/PlaylistItemPlaybackListResponse' description: Successful Response '422': content: application/vnd.api+json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - HTTPBearer: [] components: schemas: PlaylistItemPlaybackListResponse: description: >- Collection JSON:API response wrapping a list of PlaylistItemPlaybackResources. properties: data: items: $ref: >- #/components/schemas/JsonApiResource_PlaylistItemPlaybackAttributes_ title: Data type: array included: anyOf: - items: {} type: array - type: 'null' title: Included links: anyOf: - $ref: '#/components/schemas/JsonApiPaginationLinks' - type: 'null' meta: anyOf: - additionalProperties: true type: object - type: 'null' title: Meta required: - data title: PlaylistItemPlaybackListResponse type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object JsonApiResource_PlaylistItemPlaybackAttributes_: properties: attributes: $ref: '#/components/schemas/PlaylistItemPlaybackAttributes' id: title: Id type: string links: anyOf: - $ref: '#/components/schemas/JsonApiLinks' - type: 'null' meta: anyOf: - additionalProperties: true type: object - type: 'null' title: Meta relationships: anyOf: - additionalProperties: true type: object - type: 'null' title: Relationships type: title: Type type: string required: - id - type - attributes title: JsonApiResource[PlaylistItemPlaybackAttributes] type: object JsonApiPaginationLinks: properties: next: anyOf: - type: string - type: 'null' title: Next self: anyOf: - type: string - type: 'null' title: Self title: JsonApiPaginationLinks type: object ValidationError: properties: ctx: title: Context type: object input: title: Input loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object PlaylistItemPlaybackAttributes: description: >- Public/playback view of a playlist item — has signed URL, not raw file row. properties: asset_kind: anyOf: - enum: - video - audio - pdf - image - document type: string - type: 'null' title: Asset Kind content_node_id: anyOf: - type: string - type: 'null' description: Hub-scoped content node id. title: Content Node Id description: anyOf: - type: string - type: 'null' description: File description. title: Description duration_seconds: anyOf: - type: integer - type: 'null' description: Media duration in seconds. title: Duration Seconds expires_at: anyOf: - format: date-time type: string - type: 'null' description: >- When the playback URL expires. Null whenever playback_url is null (byte-less/synthetic document with no S3 object to sign). Always present; may be null. title: Expires At file_id: description: Underlying file id. title: File Id type: string mime_type: anyOf: - type: string - type: 'null' description: >- The media's raw MIME type (e.g. video/mp4, text/markdown). A synchronous kind hint for clients switching between playlist items — lets a player pick a text vs. video renderer without waiting on a slower signal. Always present; may be null. title: Mime Type playback_url: anyOf: - type: string - type: 'null' description: >- CloudFront-signed playback URL. Null when the underlying file is byte-less (e.g. a synthetic/placeholder document with no S3 object) — no URL is signed in that case, but the item is still returned with its other metadata. Always present; may be null. title: Playback Url position: description: 0-indexed position in the playlist. minimum: 0 title: Position type: integer poster_variants: additionalProperties: type: string description: >- Signed imgproxy poster URLs keyed by preset (thumbnail-160/medium-720/large-1440/webp-medium). Empty when no poster. title: Poster Variants type: object poster_variants_expires_at: anyOf: - format: date-time type: string - type: 'null' description: Earliest poster variant expiry; null when poster_variants is empty. title: Poster Variants Expires At title: anyOf: - type: string - type: 'null' description: File title. title: Title unique_viewer_count: anyOf: - minimum: 0 type: integer - type: 'null' description: >- Global count of distinct non-opted-out contacts with visits>0 for this item's resolved hub-scoped content node. null for anonymous callers, missing hub scope, or missing/ambiguous content-node mapping. Reflects retained progress rows and may decrease after retention/GDPR cleanup. NOT a replay/plays total and NOT an immutable lifetime analytics count. title: Unique Viewer Count required: - file_id - position - playback_url - expires_at - mime_type title: PlaylistItemPlaybackAttributes type: object JsonApiLinks: properties: self: anyOf: - type: string - type: 'null' title: Self title: JsonApiLinks type: object securitySchemes: bearerAuth: bearerFormat: JWT or mio_sk API key description: >- Send platform JWTs, contact JWTs, or team API keys as `Authorization: Bearer `. scheme: bearer type: http HTTPBearer: scheme: bearer type: http ````