> ## Documentation Index > Fetch the complete documentation index at: https://docs.magicmealkits.com/llms.txt > Use this file to discover all available pages before exploring further. # Get recording bundle > Backend-for-frontend: returns the file plus any combination of transcript, summary, share state, and audio URL in a single call. **Pro license required.** ## OpenAPI ````yaml /api-reference/plaud/openapi.json get /plaud/files/{id}/fetch openapi: 3.1.0 info: title: Magic Meal Kits — Plaud API version: 1.0.0 description: >- Read your Plaud voice-recorder library — recordings, transcripts, AI summaries, note tabs, devices, and search — through your Magic Meal Kits server. Backs the **Plaud (Magic Meal Kits)** Make.com app. Your Plaud account credentials live server-side (Secret Manager) on your deployment; callers only send the MMK API key. Every endpoint requires a **Pro** license — a Basic key is rejected with `400` and `you are not a magic meal kits PRO user`. license: name: Proprietary identifier: LicenseRef-Proprietary servers: - url: https://{deployment}/api/v1 description: Your Magic Meal Kits deployment variables: deployment: default: magic-meal-kits-xxxxx.run.app description: Your Cloud Run host (without protocol) security: - ApiKeyAuth: [] tags: - name: User description: Account profile and membership. - name: Files description: List, inspect, and bundle recordings. - name: Content description: Transcripts, summaries, note tabs, and audio. - name: Search description: Full-text search across transcripts. - name: Devices description: Bound Plaud hardware. - name: Webhooks description: Polling source for new-recording triggers. paths: /plaud/files/{id}/fetch: get: tags: - Files summary: Get recording bundle description: >- Backend-for-frontend: returns the file plus any combination of transcript, summary, share state, and audio URL in a single call. **Pro license required.** operationId: getPlaudFileBundle parameters: - $ref: '#/components/parameters/FileId' - name: include in: query schema: type: string default: transcript,summary description: >- Comma-separated attachments to compose. Accepted tokens: `transcript`, `summary`, `share`, `audio_url` (alias `audio-url`). When omitted, defaults to `transcript,summary` — `share` and `audio_url` are only included when explicitly requested. - name: transcript_format in: query schema: type: string enum: - text - markdown - srt - vtt - json - plain description: >- Rendering applied to the bundled transcript's `text`. Defaults to `text`. - name: strict in: query schema: type: boolean default: false description: >- Fail-fast on any sub-fetch error instead of collecting per-attachment errors. responses: '200': description: Composed file bundle content: application/json: schema: $ref: '#/components/schemas/FileBundle' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/PlaudAuthError' '409': $ref: '#/components/responses/NotReady' components: parameters: FileId: name: id in: path required: true schema: type: string description: Plaud recording (file) ID. schemas: FileBundle: type: object description: >- File detail plus opted-in attachments. `file` is the inner file-detail object (`file.file_id`, …), not a `{status,data}` envelope. `transcript`/`summary`/`share`/`audio_url` appear only when requested via `include` and the fetch succeeded. properties: file: $ref: '#/components/schemas/FileDetailData' transcript: $ref: '#/components/schemas/Transcript' summary: $ref: '#/components/schemas/Summary' share: type: object description: Private/public share state — present only when `include=share`. properties: private: type: object additionalProperties: true public: type: object additionalProperties: true audio_url: type: string errors: type: array items: type: string description: Per-attachment failures (non-strict mode). not_ready: type: array items: type: string description: Requested attachments that are not generated yet. FileDetailData: type: object description: >- Inner file-detail object — the `data` of FileDetailResponse and the `file` of a bundle. properties: file_id: type: string file_name: type: string duration: type: integer format: int64 is_trash: type: boolean start_time: type: integer format: int64 filetag_id_list: type: array items: type: string is_trans: type: boolean is_summary: type: boolean Transcript: type: object properties: file_id: type: string content: description: >- Decoded transcript payload (object or array of speaker-labeled segments). text: type: string description: Rendered transcript — present only when `format` was requested. format: type: string description: Echoes the requested format. Summary: type: object properties: file_id: type: string source: type: string enum: - inline - s3 markdown: type: string description: Summary as Markdown with image paths rewritten to pre-signed URLs. images: type: array items: type: object properties: path: type: string url: type: string description: Pre-signed S3 URL (~15-min TTL). ErrorResponse: type: object properties: error: type: string responses: BadRequest: description: Invalid request (e.g. missing file id) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' PlaudAuthError: description: >- Plaud credentials rejected (revoked/expired) — reconnect your Plaud account. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotReady: description: >- The requested attachment is not generated yet (e.g. transcription still running) content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-KEY description: >- Your deployment's API key (MMK_API_KEY). Your Plaud account credentials are stored server-side — you do not send them. ````