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

# List artifacts for a job



## OpenAPI

````yaml /openapi.json get /api/v1/jobs/{jobId}/artifacts
openapi: 3.1.0
info:
  title: AnythingMD API
  version: 1.0.0-preview
  description: >-
    Convert PDFs, Office documents, spreadsheets and images into Markdown.
    Guides, pricing and limits: https://docs.anythingmd.com. Preview: available
    to workspaces that have purchased credits.
servers:
  - url: https://anythingmd.com
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Uploads
    description: Stage a source document for conversion
  - name: Jobs
    description: Create and observe async conversion work
  - name: Artifacts
    description: Retrieve job outputs
  - name: Quotes
    description: See what a conversion would cost before starting it.
  - name: Receipts
    description: What a job was charged. Receipts outlive the job.
paths:
  /api/v1/jobs/{jobId}/artifacts:
    get:
      tags:
        - Artifacts
      summary: List artifacts for a job
      operationId: listJobArtifacts
      parameters:
        - name: jobId
          in: path
          required: true
          schema:
            type: string
            minLength: 1
            description: Id of an async job
      responses:
        '200':
          description: Artifact list (empty while job is still running)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListArtifactsResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '403':
          description: >-
            Authenticated, but the credential lacks the scope this operation
            requires (code: insufficient_scope). Reads need documents:read,
            uploads and job creation need documents:write, cancel needs
            documents:delete. Checked before the resource is looked up, so this
            never reveals whether the resource exists.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
        '404':
          description: Resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiError'
components:
  schemas:
    ListArtifactsResponse:
      type: object
      properties:
        jobId:
          type: string
          minLength: 1
          description: Id of an async job
        artifacts:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                minLength: 1
                description: Id of a job output artifact
              jobId:
                type: string
                minLength: 1
                description: Id of an async job
              kind:
                type: string
                enum:
                  - markdown
                  - image
                  - zip
                  - metadata
              contentType:
                type: string
                description: MIME type, e.g. text/markdown or image/png
              fileName:
                description: Suggested download file name
                type: string
              sizeBytes:
                type: integer
                minimum: 0
                maximum: 9007199254740991
              downloadUrl:
                description: Time-limited URL to download the artifact bytes
                type: string
              text:
                description: >-
                  Inline text content when kind is markdown/metadata and small
                  enough
                type: string
              contentHash:
                description: >-
                  SHA-256 of artifact bytes as sha256:<hex>. Omitted when bytes
                  were not available to hash (e.g. external zip URL).
                type: string
              expiresAt:
                description: >-
                  When artifact metadata/bytes may be deleted (aligned with job
                  retention)
                type: string
                format: date-time
                pattern: >-
                  ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
              createdAt:
                type: string
                format: date-time
                pattern: >-
                  ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
            required:
              - id
              - jobId
              - kind
              - contentType
              - createdAt
            additionalProperties: false
      required:
        - jobId
        - artifacts
      additionalProperties: false
    ApiError:
      type: object
      properties:
        error:
          type: string
          description: User-facing error message
        code:
          description: Optional machine-readable error code (e.g. invalid_request)
          type: string
      required:
        - error
      additionalProperties: false
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API key
      description: >-
        Create a key under Settings → API Keys and send it as `Authorization:
        Bearer amd_live_…`. See https://docs.anythingmd.com/authentication.

````

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