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

# List evidence uploads for a case

> Returns the uploads the user is allowed to access for a given case.



## OpenAPI

````yaml /api-reference/api.yaml post /evidence/uploads/list
openapi: 3.0.3
info:
  title: api
  description: >-
    The API service is the secure public gateway to our platform, letting people
    access features without touching our private internal APIs. It authenticates
    clients with its own internal tokens and then routes their requests to the
    right internal services behind the scenes.
  version: 1.0.0
servers:
  - url: https://api.platform.arb.inc
security: []
tags:
  - name: cases
  - name: docket
  - name: evidence
  - name: filings
  - name: organization
  - name: participants
  - name: schemas
  - name: service-of-notice
paths:
  /evidence/uploads/list:
    post:
      tags:
        - evidence
      summary: List evidence uploads for a case
      description: Returns the uploads the user is allowed to access for a given case.
      operationId: listEvidenceUploads
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - caseID
              properties:
                caseID:
                  type: string
                  description: The case identifier to look up uploads for.
                  minLength: 1
                  maxLength: 36
                  example: 2025-08-00123
      responses:
        '200':
          description: Successfully returned uploads the user is allowed to access.
          content:
            application/json:
              schema:
                type: object
                properties:
                  uploads:
                    type: array
                    description: List of evidence uploads visible to the user.
                    items:
                      type: object
                      properties:
                        created:
                          type: string
                          format: date-time
                          description: When the evidence was submitted (RFC 3339).
                          example: '2025-08-29T16:27:16Z'
                        uploadID:
                          type: string
                          description: Unique identifier for the upload.
                          example: '4'
                        categoryID:
                          type: string
                          description: Evidence category classification.
                          example: document
                        phaseID:
                          type: string
                          description: Case phase at submission.
                          example: caseInitiation
                        partyID:
                          type: string
                          description: Party linked to the evidence.
                          example: claimant
                        userID:
                          type: string
                          description: User who submitted the evidence.
                          example: 00c573fd-18d9-4fbe-921e-6926d2c4869e
                        organizationID:
                          type: string
                          nullable: true
                          description: Organization the user belongs to, if any.
                          example: 8a922e11-1821-4923-a860-58683cbda9a2
                        description:
                          type: string
                          description: Text description of the evidence.
                          example: This is my description
                        contentType:
                          type: string
                          description: MIME type of the uploaded file.
                          example: application/pdf
              examples:
                sample:
                  summary: Example response
                  value:
                    uploads:
                      - created: '2025-08-29T15:41:19Z'
                        uploadID: '1'
                        categoryID: image
                        phaseID: caseInitiation
                        partyID: claimant
                        userID: 00c573fd-18d9-4fbe-921e-6926d2c4869e
                        organizationID: 8a922e11-1821-4923-a860-58683cbda9a2
                        description: Photo of the building
                        contentType: application/png
                      - created: '2025-08-29T15:45:09Z'
                        uploadID: '2'
                        categoryID: document
                        phaseID: caseInitiation
                        partyID: claimant
                        userID: 00c573fd-18d9-4fbe-921e-6926d2c4869e
                        organizationID: 8a922e11-1821-4923-a860-58683cbda9a2
                        description: Terms of service
                        contentType: application/pdf
        '404':
          description: The case was not found or the user is not a participant.
          content:
            text/plain:
              schema:
                type: string
                example: case not found
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      description: access token
      scheme: bearer
      bearerFormat: JWT

````