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

# Search selectable Scenario Lab brands

> Returns all current-environment non-deleted role_id=1 accounts matching the optional search, regardless of account status, test-account classification, onboarding, or ordinary product eligibility.



## OpenAPI

````yaml /storage/api-docs/api-docs.json get /internal/qa-scenario-lab/brands
openapi: 3.0.0
info:
  title: MOGL Core API
  description: >-
    MOGL Platform Core API — powering athlete NIL deals, brand partnerships,
    agent management, payments, messaging, and more.
     *
     * ## Authentication
     * - **JWT Bearer Token**: Most endpoints require a Bearer token obtained via `/api/login`.
     * - **Server-to-Server API Key**: Internal/lambda/cron endpoints use an `X-API-KEY` header.
     *
     * ## Rate Limiting
     * - Registration & login endpoints: 4–15 requests per minute
     * - Public/influencer endpoints: 200 requests per minute
     * - Authenticated endpoints: standard Laravel throttle
  version: 1.0.0
servers:
  - url: http://localhost/mogl/mogl-backend/api
    description: Local
  - url: https://dev-api.mogl.online/api
    description: Dev
  - url: https://staging-api.mogl.online/api
    description: Staging
  - url: https://api.mogl.online/api
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Login, registration, password reset
  - name: User Registration - Common
    description: Common user registration & email check
  - name: User Registration - Athlete
    description: Athlete registration & onboarding steps
  - name: User Registration - Partner
    description: Partner/Brand registration & onboarding steps
  - name: User Registration - Agent
    description: Agent registration & onboarding steps
  - name: User Registration - Fan
    description: Fan registration & onboarding steps
  - name: User Profile
    description: User profile management, settings, social media
  - name: Athlete
    description: 'Athlete-specific endpoints: search, details, availability'
  - name: Athlete - Availability Confirmation
    description: Post-hiring availability confirmation workflow
  - name: Athlete - NIL Feed
    description: Athlete NIL feed and partner search
  - name: Athlete - AI Assistant
    description: >-
      AI-powered job assistant for athletes — chat, conversation history, read
      state, and clarification drafts
  - name: Athlete - AI Waitlist
    description: AI Athlete Assistant waitlist status, social proof, and joining
  - name: Partner
    description: Partner/Brand-specific endpoints
  - name: Partner - External Job
    description: External job link & applicant management
  - name: Partner - Deliverable Report
    description: Deliverable detail reports for brands
  - name: Partner - Screening Questions
    description: Screening question reports
  - name: Partner - Contract Management
    description: Brand contract management with athletes
  - name: Partner - Content Library
    description: Brand content library for deliverable assets
  - name: Agent
    description: Agent profile, athlete management, contracts
  - name: Agent - Athletes
    description: Agent-athlete relationship management
  - name: Agent - Stripe
    description: Agent payment methods & billing via Stripe
  - name: Agent - Pay
    description: 'Agent-wide payout feed: money MOGL sends the agent through Stripe Express'
  - name: Agent - Contracts
    description: Agent athlete contract management
  - name: Agent - Availability Confirmation
    description: Agent managing athlete job availability
  - name: Agent - Roster Import
    description: >-
      CSV client list import through CSVBox (ENG-1619 / ENG-1702): session,
      CSVBox webhook, progress, row results, retry
  - name: Agent - Roster Pages
    description: >-
      ENG-1685: My Roster Link, public roster directory, public roster page, and
      roster SEO URL resolution. A roster is the agent's current linked
      athletes; nothing is stored separately.
  - name: Jobs
    description: Job/deal CRUD, search, invitations, hiring, deliverables
  - name: Deals
    description: Deal listing, my deals, bulk operations
  - name: Deal Folder
    description: >-
      Deal folder file workflow — uploads, replacements, approvals, revisions,
      comments. Accessible by athlete, partner/brand, agent, and iOS clients
      (per-action authorisation enforced server-side).
  - name: Deal Folder iOS API
    description: >-
      iOS-only direct-to-S3 multipart upload endpoints for deal folder files
      (initiate/complete for new uploads and replacements). Web clients should
      use the standard `Deal Folder` upload/replace endpoints instead.
  - name: Chat
    description: Messaging, chat contacts, notifications
  - name: Notifications
    description: Notification preferences, in-app notifications
  - name: Payments
    description: Stripe payments, payment history, cards, bulk pay
  - name: Subscription
    description: Brand subscription plans & management
  - name: Public Pages
    description: Public content endpoints (no auth required)
  - name: Public - Influencer/SEO
    description: Public influencer discovery, sitemaps, directories
  - name: Services
    description: Athlete service marketplace
  - name: iOS Device
    description: iOS device tokens, live activities
  - name: Onboarding Tutorial
    description: Onboarding tutorial progress
  - name: MOGL Rosters
    description: Roster management & display
  - name: Internal / Cron
    description: Server-to-server and cron job endpoints
  - name: Internal / AI Assistant Tools
    description: >-
      Server-to-server Athlete Assistant tool gateway used by mogl-ai-service.
      Eight Laravel tools share POST /internal/ai-assistant/tools/{tool}.
      search_kb is Python-local and is not in this path enum.
  - name: Internal / QA Scenario Lab
    description: >-
      Feature-flagged DEV/STAGING-only endpoints called by the authorized Back
      Office QA Scenario Lab.
  - name: Affiliate
    description: Athlete affiliate links & tracking
  - name: Internal
    description: Internal
  - name: Public - Social Linking
    description: Public - Social Linking
paths:
  /internal/qa-scenario-lab/brands:
    get:
      tags:
        - Internal / QA Scenario Lab
      summary: Search selectable Scenario Lab brands
      description: >-
        Returns all current-environment non-deleted role_id=1 accounts matching
        the optional search, regardless of account status, test-account
        classification, onboarding, or ordinary product eligibility.
      operationId: searchQaScenarioLabBrands
      parameters:
        - $ref: '#/components/parameters/QaScenarioLabApiKey'
        - $ref: '#/components/parameters/QaScenarioLabAdminId'
        - $ref: '#/components/parameters/QaScenarioLabTimestamp'
        - $ref: '#/components/parameters/QaScenarioLabNonce'
        - $ref: '#/components/parameters/QaScenarioLabPermission'
        - $ref: '#/components/parameters/QaScenarioLabSignature'
        - name: q
          in: query
          description: >-
            Case-insensitive name or email search. A numeric value also matches
            account ID.
          required: false
          schema:
            type: string
            maxLength: 100
        - name: cursor
          in: query
          required: false
          schema:
            type: string
            maxLength: 2048
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 25
            maximum: 100
            minimum: 1
      responses:
        '200':
          description: Cursor-paginated selectable brands.
          content:
            application/json:
              schema:
                required:
                  - data
                  - meta
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/QaScenarioLabActor'
                  meta:
                    $ref: '#/components/schemas/QaScenarioLabSelectorMeta'
                type: object
        '401':
          description: Missing, invalid, or expired credentials.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedResponse'
        '409':
          description: Signed nonce was already used.
        '422':
          description: Invalid search or cursor.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationErrorResponse'
      security:
        - serverToServerApiKey: []
          qaScenarioLabSignature: []
components:
  parameters:
    QaScenarioLabApiKey:
      name: X-API-KEY
      in: header
      description: Dedicated QA Scenario Lab service credential.
      required: true
      schema:
        type: string
    QaScenarioLabAdminId:
      name: X-QA-Lab-Admin-Id
      in: header
      description: >-
        Positive initiating Back Office administrator ID included in the
        signature.
      required: true
      schema:
        type: integer
        minimum: 1
        example: 42
    QaScenarioLabTimestamp:
      name: X-QA-Lab-Timestamp
      in: header
      description: Ten-digit Unix timestamp. Default maximum age is 300 seconds.
      required: true
      schema:
        type: integer
        format: int64
        example: 1791194024
    QaScenarioLabNonce:
      name: X-QA-Lab-Nonce
      in: header
      description: One-use UUID included in the signature.
      required: true
      schema:
        type: string
        format: uuid
    QaScenarioLabPermission:
      name: X-QA-Lab-Permission
      in: header
      description: Signed permission claim.
      required: true
      schema:
        type: string
        enum:
          - qa_scenario_lab
    QaScenarioLabSignature:
      name: X-QA-Lab-Signature
      in: header
      description: Lowercase hexadecimal HMAC-SHA256 of the canonical request envelope.
      required: true
      schema:
        type: string
        maxLength: 64
        minLength: 64
        pattern: ^[a-f0-9]{64}$
  schemas:
    QaScenarioLabActor:
      required:
        - id
        - name
        - email
        - role
        - status
        - is_test_account
      properties:
        id:
          type: integer
          minimum: 1
          example: 101
        name:
          type: string
          example: Jordan Smith
        email:
          type: string
          format: email
          example: jordan@example.test
          nullable: true
        role:
          type: string
          enum:
            - brand
            - athlete
          example: athlete
        status:
          type: string
          example: A
          nullable: true
        is_test_account:
          type: boolean
          example: true
      type: object
    QaScenarioLabSelectorMeta:
      required:
        - per_page
        - next_cursor
        - previous_cursor
        - has_more
      properties:
        per_page:
          type: integer
          maximum: 100
          minimum: 1
          example: 25
        next_cursor:
          type: string
          nullable: true
        previous_cursor:
          type: string
          nullable: true
        has_more:
          type: boolean
          example: false
      type: object
    UnauthorizedResponse:
      properties:
        message:
          type: string
          example: Unauthenticated.
      type: object
    ValidationErrorResponse:
      properties:
        message:
          type: string
          example: The given data was invalid.
        errors:
          type: object
          additionalProperties:
            type: array
            items:
              type: string
      type: object
  securitySchemes:
    bearerAuth:
      type: http
      description: >-
        JWT Bearer token authentication. Use the /api/login endpoint to obtain a
        token.
      scheme: bearer
      bearerFormat: JWT
    serverToServerApiKey:
      type: apiKey
      description: Server-to-Server API Key for internal/lambda/cron calls
      name: X-API-KEY
      in: header
    qaScenarioLabSignature:
      type: apiKey
      description: >-
        HMAC-SHA256 signature for a one-use, short-lived Back Office
        administrator envelope. Used together with the dedicated X-API-KEY
        credential and the signed administrator, timestamp, nonce, and
        permission headers.
      name: X-QA-Lab-Signature
      in: header

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.