> ## Documentation Index
> Fetch the complete documentation index at: https://help.eazybe.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get media metadata

> Returns media metadata and a short-lived Meta download URL.

<Warning>The returned URL expires quickly and requires Meta authorization. Download it from your server instead of exposing it to a browser.</Warning>


## OpenAPI

````yaml /api-reference/meta/openapi.yaml get /meta/media/{mediaId}
openapi: 3.1.0
info:
  title: Eazybe Meta API Documentation
  version: 1.0.0
  description: |
    A single authenticated Eazybe REST surface over WhatsApp Business Cloud API.
    The wrapper uses the Meta credentials captured when a WABA is connected to
    Eazybe, so callers never send Meta access tokens directly.
servers:
  - url: https://cerberus.eazybe.com/staging/api/v2
    description: Eazybe staging API v2.
security:
  - bearerAuth: []
tags:
  - name: Phone numbers
    description: Discover connected WABAs and phone-number IDs.
  - name: Messaging
    description: Send WhatsApp messages and update message state.
  - name: Templates
    description: Manage WhatsApp message templates.
  - name: Media
    description: Upload, inspect, and delete WhatsApp media.
  - name: Webhooks
    description: Manage WABA webhook subscriptions.
  - name: Analytics
    description: Read messaging, conversation, pricing, and template analytics.
  - name: Profiles and settings
    description: Manage business profiles and phone-number settings.
  - name: Automation
    description: Configure welcome messages, ice-breakers, and commands.
  - name: QR codes
    description: Manage click-to-chat QR codes.
  - name: Flows
    description: Manage the WhatsApp Flows lifecycle.
  - name: Number administration
    description: Register numbers, manage PINs, and synchronize coexistence data.
  - name: Block list
    description: List, block, and unblock WhatsApp users.
paths:
  /meta/media/{mediaId}:
    parameters:
      - name: mediaId
        in: path
        required: true
        description: Media ID returned by the upload operation.
        schema:
          type: string
      - name: phoneNumberId
        in: query
        required: true
        description: Phone-number ID that owns the media.
        schema:
          type: string
    get:
      tags:
        - Media
      summary: Get media metadata
      description: Returns media metadata and a short-lived Meta download URL.
      operationId: getMedia
      responses:
        '200':
          description: >-
            Metadata returned


            **Failure responses**


            | **Status** | **Meaning** | **Action** |

            | --- | --- | --- |

            | `401` | Missing, invalid, or expired bearer token |
            Re-authenticate |

            | `404` | `phoneNumberId` missing from the query or not linked to
            your organization | Always pass `?phoneNumberId=` |

            | `400` | `mediaId` unknown or already deleted | Re-upload the asset
            |

            | `502` | Graph unreachable or timed out | Retry with backoff |
          content:
            application/json:
              schema:
                type: object
                required:
                  - url
                  - mime_type
                  - sha256
                  - file_size
                  - id
                  - messaging_product
                properties:
                  url:
                    type: string
                  mime_type:
                    type: string
                  sha256:
                    type: string
                  file_size:
                    type: integer
                  id:
                    type: string
                  messaging_product:
                    type: string
              example:
                url: >-
                  https://lookaside.fbsbx.com/whatsapp_business/attachments/?mid=1234567890123456&ext=1754500000&hash=ATtR2...
                mime_type: application/pdf
                sha256: >-
                  9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08
                file_size: 84213
                id: '1234567890123456'
                messaging_product: whatsapp
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Eazybe token
      description: |
        Eazybe bearer token. The token resolves the caller's organization and
        must be kept on the server.

````