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

# Get Submission Status

> Poll the bounded review and promotion status for a governed portfolio submission.

Stage-only service actors can read submissions created by their own TattooAPI actor mapping. The response omits private storage pointers, raw review notes, and credential-mapping details.


## OpenAPI

````yaml openapi-portfolio-intake.json GET /submissions/{submissionId}
openapi: 3.1.0
info:
  title: TattooAPI Portfolio Intake
  version: 1.0.0
  description: >-
    Private, review-gated portfolio intake for approved partners and TattooAPI
    operators. These operations never publish directly to public surfaces.
servers:
  - url: https://api.tattooapi.com/api/private/portfolio-intake/v1
    description: Production private portfolio intake
security: []
paths:
  /submissions/{submissionId}:
    get:
      summary: Get portfolio submission status
      description: >-
        Requires portfolio_intake:stage. Staging services can read only
        submissions created by their own TattooAPI actor mapping. Reviewers with
        portfolio_intake:review can inspect the governed queue.
      operationId: getPortfolioIntakeSubmission
      parameters:
        - $ref: '#/components/parameters/SubmissionId'
      responses:
        '200':
          description: Bounded status projection
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PortfolioStatusResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '404':
          description: Submission not found
      security:
        - ApiKeyAuth: []
        - BearerAuth: []
components:
  parameters:
    SubmissionId:
      name: submissionId
      in: path
      required: true
      schema:
        type: string
        maxLength: 200
  schemas:
    PortfolioStatusResponse:
      type: object
      properties:
        success:
          type: boolean
          const: true
        data:
          type: object
          properties:
            submissionId:
              type: string
            artistCanonicalId:
              type: string
            intakeStatus:
              type: string
            reviewStatus:
              type: string
            sanityDocumentId:
              type:
                - string
                - 'null'
            governance:
              type: object
              properties:
                reviewRequired:
                  type: boolean
                promotedToSanity:
                  type: boolean
                publicSurfaceActivated:
                  type: boolean
                  const: false
                canonicalConvexMutationExecuted:
                  type: boolean
                  const: false
  responses:
    Unauthorized:
      description: Missing or invalid WorkOS credential
    Forbidden:
      description: Credential is unmapped, out of scope, or lacks the required permission
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: WorkOS organization API key mapped to a TattooAPI service actor.
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: WorkOS AuthKit bearer token mapped to a TattooAPI human actor.

````