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

# Get result export

> Poll a format-driven result export and refresh expiring artifact URLs.

Pass the same format and content-selection query used for the request. Pending/running exports return `202`; ready native or generated artifacts return `200`.


## OpenAPI

````yaml GET /jobs/{id}/exports
openapi: 3.1.0
info:
  title: Strand AI Platform API
  version: v1
  description: >-
    REST surface for uploading WSIs, submitting Lattice inference jobs, and
    streaming results. All endpoints require an API key or Strand AI OAuth
    access token in the `Authorization: Bearer` header.
servers:
  - url: https://app.strandai.com/api/v1
    description: Production
security:
  - ApiKey: []
  - OAuth2: []
paths:
  /jobs/{id}/exports:
    get:
      summary: Get format-driven result export status
      description: Poll an asynchronous export and refresh expiring signed URLs.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: format
          in: query
          required: true
          schema:
            type: string
            enum:
              - ome-zarr
              - ome-zarr-zip
              - ome-tiff
        - name: includeHe
          in: query
          description: Include processed/registered H&E.
          schema:
            type: boolean
            default: false
        - name: includeSegmentation
          in: query
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: Result ready
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResultExport'
        '202':
          description: Export pending or running
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResultExport'
        '400':
          description: Invalid selection value
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Authentication required
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: OAuth token lacks a required scope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Job or export not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '409':
          description: Job has no completed results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - ApiKey: []
        - OAuth2:
            - jobs:read
            - results:read
components:
  schemas:
    ResultExport:
      type: object
      required:
        - schemaVersion
        - status
        - format
        - selection
        - expiresAt
        - retryable
        - error
        - artifacts
      properties:
        schemaVersion:
          type: string
          enum:
            - '1.0'
        status:
          type: string
          enum:
            - pending
            - running
            - ready
            - failed
        format:
          type: string
          enum:
            - ome-zarr
            - ome-zarr-zip
            - ome-tiff
        selection:
          type: object
          additionalProperties: false
          properties:
            includeHe:
              type: boolean
            includeSegmentation:
              type: boolean
        expiresAt:
          type: string
          format: date-time
          nullable: true
        retryable:
          type: boolean
        error:
          type: string
          nullable: true
        artifacts:
          type: object
          additionalProperties: false
          required:
            - prediction
            - he
            - segmentation
          properties:
            prediction:
              type: object
              additionalProperties: false
              required:
                - format
                - role
                - dataModel
                - stored
                - converted
              properties:
                format:
                  type: string
                  enum:
                    - ome-zarr-v3
                    - ome-zarr-zip
                    - ome-tiff
                role:
                  type: string
                  enum:
                    - predicted-mif
                dataModel:
                  type: string
                  enum:
                    - pixel-grid
                stored:
                  type: boolean
                converted:
                  type: boolean
                includesHe:
                  type: boolean
                rootUrl:
                  type: string
                  nullable: true
                baseUrl:
                  type: string
                downloadUrl:
                  type: string
                  nullable: true
                sizeBytes:
                  type: integer
                  nullable: true
            he:
              type: object
              nullable: true
              additionalProperties: false
              required:
                - format
                - role
                - rootUrl
                - baseUrl
              properties:
                format:
                  type: string
                  enum:
                    - ome-zarr-v3
                role:
                  type: string
                  enum:
                    - processed-registered-he
                rootUrl:
                  type: string
                baseUrl:
                  type: string
            segmentation:
              allOf:
                - $ref: '#/components/schemas/SegmentationManifest'
              nullable: true
    Error:
      type: object
      required:
        - error
        - message
      properties:
        error:
          type: string
        message:
          type: string
        required:
          type: integer
          nullable: true
        retryAfterSeconds:
          type: integer
          nullable: true
    SegmentationManifest:
      type: object
      description: >-
        Explicit per-cell contract. Mask pixels are uint32 local labels;
        morphology and marker Parquet tables join by instance_id. This is
        distinct from pixel-grid prediction matrices.
      required:
        - schemaVersion
        - layerId
        - entityType
        - modelVersion
        - coordinateFrame
        - instanceCount
        - createdAt
        - artifacts
      properties:
        schemaVersion:
          type: string
          enum:
            - '1.0'
        layerId:
          type: string
          format: uuid
        entityType:
          type: string
        modelVersion:
          type: string
        coordinateFrame:
          type: string
        instanceCount:
          type: integer
          nullable: true
        createdAt:
          type: string
          format: date-time
        artifacts:
          type: object
          additionalProperties: false
          required:
            - mask
            - cells
            - provenance
          properties:
            mask:
              type: object
              nullable: true
              additionalProperties: false
              required:
                - format
                - dtype
                - baseUrl
              properties:
                format:
                  type: string
                  enum:
                    - ome-zarr-v3
                dtype:
                  type: string
                  enum:
                    - uint32
                baseUrl:
                  type: string
            cells:
              type: object
              nullable: true
              additionalProperties: false
              required:
                - format
                - morphologyUrl
                - markerExpressionBaseUrl
                - markers
                - joinKey
                - maskJoinKey
                - geometry
                - morphology
                - expression
              properties:
                format:
                  type: string
                  enum:
                    - parquet
                morphologyUrl:
                  type: string
                markerExpressionBaseUrl:
                  type: string
                markers:
                  type: array
                  items:
                    type: string
                joinKey:
                  type: string
                  enum:
                    - instance_id
                maskJoinKey:
                  type: string
                  enum:
                    - local_label
                geometry:
                  type: array
                  items:
                    type: string
                  description: Per-cell centroid columns in the declared coordinate frame.
                morphology:
                  type: array
                  items:
                    type: string
                  description: Per-cell shape measurements in instances.parquet.
                expression:
                  type: array
                  items:
                    type: string
                  description: >-
                    Per-cell marker summary columns, distinct from pixel-grid
                    arrays.
            provenance:
              type: object
              nullable: true
              additionalProperties: false
              required:
                - format
                - url
              properties:
                format:
                  type: string
                  enum:
                    - json
                url:
                  type: string
  securitySchemes:
    ApiKey:
      type: http
      scheme: bearer
      bearerFormat: sk-strand-XXXXXXXXXXXXXXXXXXXXXXXX
    OAuth2:
      type: oauth2
      description: >-
        Strand AI authorization-code flow with S256 PKCE, explicit organization
        consent, and RFC 8707 resource binding.
      flows:
        authorizationCode:
          authorizationUrl: https://auth.strandai.com/oauth2/auth
          tokenUrl: https://auth.strandai.com/oauth2/token
          scopes:
            samples:read: Read slide metadata and estimates
            samples:write: Upload and change slides
            jobs:read: Read run status
            jobs:write: Start, export, or cancel runs
            results:read: Read and download results
            credits:spend: Reserve and spend organization credits

````