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

# Get Media Moderation Status

> Retrieves the current moderation status of a submitted media item.



## OpenAPI

````yaml /openapi.json get /get-media-status
openapi: 3.0.0
info:
  title: Pixel Patrol API
  version: 1.0.0
  description: >-
    API for submitting media for moderation and checking status.


    **Webhooks:**


    Pixel Patrol can send webhooks to notify your application about moderation
    events. These webhooks are secured using HMAC-SHA256 signatures.


    - **Signature Location:** The signature is sent in the
    `X-PixelPatrol-Signature` HTTP header for real events (`media.created`,
    `media.moderated`, etc.). For test events (`webhook.test.ping`) sent via the
    dashboard button, the signature is included in the JSON body under the
    `_pixelpatrol_signature` key.

    - **Verification:** You must verify the signature using your site's unique
    Webhook Secret (found in the Pixel Patrol dashboard under Site -> Webhooks)
    against the raw request body.


    **For detailed instructions and code examples on verifying webhook
    signatures, please see the [Webhook Verification
    Guide](/docs/api-integration/webhook-verification).**
servers:
  - url: https://api.pixelpatrol.net/functions/v1
    description: Pixel Patrol API
security: []
paths:
  /get-media-status:
    get:
      tags:
        - Media
      summary: Get Media Moderation Status
      description: Retrieves the current moderation status of a submitted media item.
      parameters:
        - name: api_key
          in: query
          required: true
          description: Your Site API Key.
          schema:
            type: string
        - name: media_id
          in: query
          required: false
          description: The Pixel Patrol Media ID.
          schema:
            type: string
            format: uuid
        - name: app_media_id
          in: query
          required: false
          description: The ID provided by your application during submission.
          schema:
            type: string
      responses:
        '200':
          description: Successfully retrieved status.
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  status:
                    type: string
                    enum:
                      - pending
                      - approved
                      - rejected
                      - pending_review
                  app_media_id:
                    type: string
                    nullable: true
                  moderated_at:
                    type: string
                    format: date-time
                    nullable: true
        '400':
          description: Missing required query parameter (media_id or app_media_id).
        '401':
          description: Invalid API Key.
        '404':
          description: Media not found.
        '500':
          description: Internal server error.

````