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

# List studio outstanding orders

> Requires orders:read. Page of unpaid, disputed, unfulfilled, Studio action, production, digital pending or delivery-unconfirmed work. No fabricated whole-Studio count.



## OpenAPI

````yaml https://api.batchrelay.com/openapi.json get /v1/studios/{studio_id}/outstanding-orders
openapi: 3.1.0
info:
  description: >-
    Provider-neutral print catalog and prepared-media validation. This document
    covers only routes owned by the Go service; it deliberately excludes
    migration-proxied order lifecycle routes and all provider payloads.
  license:
    name: Proprietary
    url: https://github.com/SENTINELITE/Batch-Relay-Go/blob/main/README.md
  title: Batch Relay API
  version: 1.0.1
servers:
  - url: https://api.batchrelay.com
security: []
tags:
  - description: >-
      Explicitly authorized purchaser context for studio order events. Event
      payloads remain free of contact details.
    name: Event context
  - description: Service health and the public API description.
    name: System
  - description: Test Mode session creation and API credential entry points.
    name: Authentication
  - description: >-
      Provider-neutral canonical catalog resources and platform-owned semantic
      definitions.
    name: Catalog
  - description: Studio-scoped guest checkout-link management.
    name: Checkout links
  - description: >-
      One-way operational event messages. Alert emails contain no message body
      and recipients read messages after Batch Relay authentication.
    name: Studio messages
  - description: >-
      Explicit, reviewable sandbox-to-Live promotion plans for forms, catalog,
      and storefront configuration.
    name: Sandbox promotions
  - description: Provider-neutral validation, quoting, and order lifecycle operations.
    name: Print orders
  - description: Managed fulfillment asset ingestion and metadata.
    name: Managed assets
  - description: Studio-scoped original asset upload sessions and objects.
    name: Studio assets
  - description: Prepared and confirmed event roster team changes.
    name: Event team changes
  - description: Authenticated studio, event, and form-management operations.
    name: Studio management
  - description: >-
      Authenticated studio retail catalog management. Draft and publication
      lifecycles are explicit per product or package.
    name: Studio catalog
  - description: >-
      Authenticated singular storefront assortment management. PATCH atomically
      publishes a new immutable assortment revision; no storefront draft
      lifecycle exists yet.
    name: Storefront
  - description: Managed media used by the studio retail catalog.
    name: Studio catalog assets
  - description: Template rendering job creation and retrieval.
    name: Template renders
  - description: >-
      Published browser-side template packages and short-lived server proof
      renders. Preview artifacts are never fulfillment artwork.
    name: Browser previews
  - description: API account and credential administration.
    name: API accounts
  - description: >-
      Standalone guest purchases; feature disabled by default. Temporary
      merchandise USD0.75 5x7 and USD1.50 8x10, plus authoritative shipping and
      tax.
    name: Consumer printing
paths:
  /v1/studios/{studio_id}/outstanding-orders:
    parameters:
      - $ref: '#/components/parameters/ClientSurface'
      - $ref: '#/components/parameters/ClientVersion'
      - $ref: '#/components/parameters/InvocationMode'
    get:
      tags:
        - Studio Operations
      summary: List studio outstanding orders
      description: >-
        Requires orders:read. Page of unpaid, disputed, unfulfilled, Studio
        action, production, digital pending or delivery-unconfirmed work. No
        fabricated whole-Studio count.
      operationId: listStudioOutstandingOrders
      parameters:
        - $ref: '#/components/parameters/StudioDelegatedAuthorization'
        - description: Opaque public studio_id. Private Convex IDs are rejected.
          in: path
          name: studio_id
          required: true
          schema:
            type: string
        - in: query
          name: customer_id
          required: false
          schema:
            type: string
        - in: query
          name: athlete_id
          required: false
          schema:
            type: string
        - in: query
          name: status
          required: false
          schema:
            type: string
        - in: query
          name: cursor
          required: false
          schema:
            type: string
        - in: query
          name: limit
          required: false
          schema:
            default: 25
            maximum: 50
            minimum: 1
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StudioRetailOrderPage'
          description: Authoritative Studio result
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StudioOperationsError'
          description: Invalid credential or expired/revoked delegated token
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StudioOperationsError'
          description: Wrong Studio, role, action scope or disabled Live effects
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StudioOperationsError'
          description: Resource unavailable in this Studio and lane
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StudioOperationsError'
          description: >-
            Stale resource, expired preview, dependency blocker or idempotency
            conflict
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StudioOperationsError'
          description: Invalid typed request or unsupported query
        '503':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StudioOperationsError'
          description: Required adapter or delegated verification is not configured
      security:
        - bearerAuth: []
components:
  parameters:
    ClientSurface:
      description: >-
        Untrusted optional analytics hint naming the calling client surface. It
        never affects authorization, routing, pricing, or behavior.
      in: header
      name: X-BatchRelay-Client-Surface
      required: false
      schema:
        maxLength: 100
        minLength: 1
        type: string
    ClientVersion:
      description: >-
        Untrusted optional analytics hint naming the calling client version. It
        never affects authorization, routing, pricing, or behavior.
      in: header
      name: X-BatchRelay-Client-Version
      required: false
      schema:
        maxLength: 100
        minLength: 1
        type: string
    InvocationMode:
      description: >-
        Untrusted optional analytics hint naming the invocation mode. It never
        affects authorization, routing, pricing, or behavior.
      in: header
      name: X-BatchRelay-Invocation-Mode
      required: false
      schema:
        maxLength: 100
        minLength: 1
        type: string
    StudioDelegatedAuthorization:
      description: >-
        Original delegated Clerk OAuth bearer. Go independently verifies
        signature/current revocation, exact resource audience, allowed OAuth
        client and action scope. Caller must match attributed API key creator.
        Never send an unverified subject header.
      in: header
      name: X-BatchRelay-Delegated-Authorization
      required: false
      schema:
        type: string
  schemas:
    StudioRetailOrderPage:
      additionalProperties: false
      properties:
        coverage:
          const: page
          type: string
        is_done:
          type: boolean
        items:
          items:
            $ref: '#/components/schemas/StudioRetailOrder'
          type: array
        next_cursor:
          type:
            - string
            - 'null'
      required:
        - items
        - next_cursor
        - is_done
        - coverage
      type: object
    StudioOperationsError:
      properties:
        error:
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
          type: object
      required:
        - error
      type: object
    StudioRetailOrder:
      additionalProperties: false
      properties:
        athletes:
          items:
            $ref: '#/components/schemas/StudioOrderAthlete'
          type: array
        buyer:
          anyOf:
            - $ref: '#/components/schemas/StudioOrderBuyer'
            - type: 'null'
        created_at:
          type: number
        currency:
          type: string
        customer_id:
          type: string
        delivery:
          anyOf:
            - $ref: '#/components/schemas/StudioOrderDelivery'
            - type: 'null'
        environment_evidence:
          type: string
        id:
          type: string
        line_items:
          anyOf:
            - items:
                $ref: '#/components/schemas/StudioOrderLine'
              type: array
            - type: 'null'
        order_code:
          type: string
        outstanding:
          items:
            type: string
          type: array
        payment_status:
          type: string
        refunded_cents:
          format: int64
          type: integer
        status:
          type: string
        studio_id:
          type: string
        total_paid_cents:
          format: int64
          type: integer
      required:
        - id
        - studio_id
        - customer_id
        - order_code
        - created_at
        - status
        - payment_status
        - total_paid_cents
        - refunded_cents
        - currency
        - athletes
        - outstanding
        - environment_evidence
      type: object
    StudioOrderAthlete:
      additionalProperties: false
      properties:
        id:
          type: string
        name:
          type: string
      required:
        - id
        - name
      type: object
    StudioOrderBuyer:
      additionalProperties: false
      properties:
        masked_email:
          anyOf:
            - type: string
            - type: 'null'
        name:
          type: string
      required:
        - name
        - masked_email
      type: object
    StudioOrderDelivery:
      additionalProperties: false
      properties:
        coverage:
          type: string
        delivery:
          $ref: '#/components/schemas/StudioDelivery'
        fulfillment_status:
          type: string
        order_id:
          type: string
        payment_status:
          type: string
        physical_delivery:
          type: string
        source_updated_at:
          type: number
      required:
        - order_id
        - payment_status
        - fulfillment_status
        - physical_delivery
        - delivery
        - source_updated_at
        - coverage
      type: object
    StudioOrderLine:
      additionalProperties: false
      properties:
        athlete_id:
          anyOf:
            - type: string
            - type: 'null'
        athlete_name:
          anyOf:
            - type: string
            - type: 'null'
        label:
          type: string
        line_total_cents:
          format: int64
          type: integer
        quantity:
          format: int64
          type: integer
      required:
        - label
        - athlete_id
        - athlete_name
        - quantity
        - line_total_cents
      type: object
    StudioDelivery:
      additionalProperties: false
      properties:
        downloads:
          anyOf:
            - $ref: '#/components/schemas/StudioDownloadDelivery'
            - type: 'null'
        prints:
          anyOf:
            - $ref: '#/components/schemas/StudioPrintDelivery'
            - type: 'null'
        reasons:
          items:
            type: string
          type: array
        state:
          type: string
      required:
        - state
        - reasons
        - prints
        - downloads
      type: object
    StudioDownloadDelivery:
      additionalProperties: false
      properties:
        claimed_at:
          anyOf:
            - format: int64
              type: integer
            - type: 'null'
        link_expires_at:
          anyOf:
            - format: int64
              type: integer
            - type: 'null'
        opened:
          type: boolean
        sent_at:
          anyOf:
            - format: int64
              type: integer
            - type: 'null'
        state:
          type: string
      required:
        - state
        - sent_at
        - claimed_at
        - link_expires_at
        - opened
      type: object
    StudioPrintDelivery:
      additionalProperties: false
      properties:
        open_studio_tasks:
          format: int64
          type: integer
        shipped_at:
          anyOf:
            - format: int64
              type: integer
            - type: 'null'
        state:
          type: string
        studio_fulfilled:
          type: boolean
      required:
        - state
        - shipped_at
        - studio_fulfilled
        - open_studio_tasks
      type: object
  securitySchemes:
    bearerAuth:
      bearerFormat: Batch Relay API key or anonymous session
      description: >-
        Batch Relay scoped API key or an anonymous Test Mode session. Scope
        names document required capabilities. Anonymous sessions are
        sandbox-only and do not authorize studio, event, billing, or Live Mode
        operations.
      scheme: bearer
      type: http

````

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