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

# List flagged media

> List the authenticated creator's media items flagged by moderation, most recent first: media removed by moderation and media currently under review. Use the `status` query parameter to narrow to one of the two.

Only moderation metadata is returned, never the media content itself. This is confidential moderation data and only ever reflects the authenticated creator's own media.

<Info>
  **Required scope**

  * `read:creator` — Access creator profiles, content, and creator-specific information.
</Info>


## OpenAPI

````yaml /openapi.json get /account-health/flagged-media
openapi: 3.1.0
info:
  title: Fanvue API
  version: '0.1'
servers: []
security: []
paths:
  /account-health/flagged-media:
    get:
      summary: List flagged media
      description: >-
        List the authenticated creator's media items flagged by moderation, most
        recent first: media removed by moderation and media currently under
        review. Use the `status` query parameter to narrow to one of the two.


        Only moderation metadata is returned, never the media content itself.
        This is confidential moderation data and only ever reflects the
        authenticated creator's own media.
      operationId: listFlaggedMedia
      parameters:
        - $ref: '#/components/parameters/ApiVersionHeader'
        - schema:
            type: number
            minimum: 1
            default: 1
            description: Page number to retrieve (starts from 1)
          required: false
          description: Page number to retrieve (starts from 1)
          name: page
          in: query
        - schema:
            type: number
            minimum: 1
            maximum: 50
            default: 15
            description: 'Number of items to return per page (1-50, default: 15)'
          required: false
          description: 'Number of items to return per page (1-50, default: 15)'
          name: size
          in: query
        - schema:
            type: string
            enum:
              - in_review
              - removed
            description: >-
              Filter to media with this moderation status. Returns both
              in_review and removed media when omitted.
          required: false
          description: >-
            Filter to media with this moderation status. Returns both in_review
            and removed media when omitted.
          name: status
          in: query
      responses:
        '200':
          description: List of flagged media
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        uuid:
                          type: string
                          format: uuid
                          description: Media UUID
                        mediaType:
                          type: string
                          enum:
                            - image
                            - video
                            - audio
                            - document
                            - unknown
                        moderationStatus:
                          type: string
                          enum:
                            - in_review
                            - removed
                          description: >-
                            Moderation status of the media: in_review (awaiting
                            a moderation decision) or removed (taken down by
                            moderation)
                        createdAt:
                          type: string
                          format: date-time
                          description: When the media was uploaded
                      required:
                        - uuid
                        - mediaType
                        - moderationStatus
                        - createdAt
                    description: The creator's flagged media items, most recent first
                  pagination:
                    type: object
                    properties:
                      page:
                        type: number
                        description: Current page number
                      size:
                        type: number
                        description: Number of records returned in this response
                      hasMore:
                        type: boolean
                        description: >-
                          Whether there are more items available on subsequent
                          pages
                    required:
                      - page
                      - size
                      - hasMore
                    description: Pagination information
                required:
                  - data
                  - pagination
              example:
                data:
                  - uuid: a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d
                    mediaType: video
                    moderationStatus: in_review
                    createdAt: '2024-02-12T18:45:00.000Z'
                  - uuid: b2c3d4e5-6f7a-4b8c-9d0e-1f2a3b4c5d6e
                    mediaType: image
                    moderationStatus: removed
                    createdAt: '2024-01-20T11:15:00.000Z'
                pagination:
                  page: 1
                  size: 2
                  hasMore: false
        '400':
          description: Bad Request - API version not supported OR validation failed
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/UnsupportedVersionError'
                  - $ref: '#/components/schemas/ValidationError'
        '401':
          $ref: '#/components/responses/UnauthorizedResponse'
        '403':
          $ref: '#/components/responses/UnauthorizedResponse'
        '410':
          $ref: '#/components/responses/SunsetVersionResponse'
        '429':
          $ref: '#/components/responses/RateLimitResponse'
      security:
        - BearerAuth:
            - read:creator
components:
  parameters:
    ApiVersionHeader:
      name: X-Fanvue-API-Version
      in: header
      required: true
      schema:
        type: string
        default: '2025-06-26'
        example: '2025-06-26'
      description: API version to use for the request
  schemas:
    UnsupportedVersionError:
      type: object
      properties:
        error:
          type: string
        message:
          type: string
      required:
        - error
        - message
      description: API version not supported
    ValidationError:
      type: object
      properties:
        errors:
          type: array
          items:
            type: string
      required:
        - errors
      description: Request validation failed
  responses:
    UnauthorizedResponse:
      description: Unauthorized Response
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
            required:
              - error
    SunsetVersionResponse:
      description: API version no longer supported (sunset)
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
              message:
                type: string
              nextVersion:
                type: string
            required:
              - error
              - message
    RateLimitResponse:
      description: Too many requests - rate limit exceeded
      headers:
        Retry-After:
          description: Number of seconds to wait before retrying the request
          schema:
            type: integer
        X-RateLimit-Limit:
          description: The maximum number of requests allowed in the current window
          schema:
            type: integer
        X-RateLimit-Remaining:
          description: The number of requests remaining in the current window
          schema:
            type: integer
        X-RateLimit-Reset:
          description: The Unix timestamp (seconds) when the rate limit window resets
          schema:
            type: integer
      content:
        application/json:
          schema:
            type: object
            properties:
              error:
                type: string
            required:
              - error
  securitySchemes:
    BearerAuth:
      type: oauth2
      description: >-
        OAuth 2.0 access token, presented as a JWT bearer token in the
        `Authorization` header. Obtain a token via the authorization-code flow;
        the scopes granted to the token determine which operations it may call.
      flows:
        authorizationCode:
          authorizationUrl: https://auth.fanvue.com/oauth2/auth
          tokenUrl: https://auth.fanvue.com/oauth2/token
          refreshUrl: https://auth.fanvue.com/oauth2/token
          scopes:
            read:self: >-
              Access your own user profile information, including basic account
              details and settings.
            read:chat: >-
              Read chat conversations, messages, and chat-related data. This
              includes viewing chat lists and message history.
            write:chat: >-
              Create new chats and send messages. This scope is required for any
              chat-related actions that modify data.
            read:experience: >-
              Exchange a fan's experience token for the resolved experience and
              the fan's identity, so an embedded fan-facing experience can
              render the right content.
            write:experience: >-
              Request that the creator publish or unpublish a fan-facing
              experience. The app mints a request token; the creator confirms
              and Fanvue performs the change.
            read:fan: Access fan-related data and information within the platform.
            read:post: Read posts, including post details, comments, likes, and tips.
            write:post: Create, edit, and manage posts and content on behalf of users.
            read:media: Access media files, images, videos, and other content assets.
            write:media: >-
              Upload, modify, and manage media files and content assets. Also
              required for vault folder management.
            read:creator: >-
              Access creator profiles, content, and creator-specific
              information.
            write:creator: Modify creator profiles, settings, and creator-specific data.
            read:insights: >-
              Access analytics, metrics, and insights data for performance
              tracking.
            read:tracking_links: >-
              Read tracking links and the users associated with them, including
              per-user tracking metadata.
            write:tracking_links: Create and delete tracking links.
            read:agency: Read agency information, including the agency's team members.
            write:agency: >-
              Manage agency team members and invites, including inviting new
              team members and creators.

````