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

# List case documents

> Returns all documents associated with a specific case, with optional filtering by category.



## OpenAPI

````yaml https://v2.proconvey.co.uk/api/v2/doc get /api/v2/cases/{id}/docs
openapi: 3.1.0
info:
  title: ProConvey Public API
  version: '2.0'
  description: Public API for case management.
servers: []
security: []
tags:
  - name: Cases
    description: Case management operations including creation, retrieval, and data access
  - name: Clients
    description: Client records for the organisation
  - name: Webhooks
    description: >-
      Webhooks available for receiving updates of events on the ProConvey
      platform
  - name: Organisations
    description: Organization management and setup
  - name: System
    description: System and utility endpoints including branches and documentation
paths:
  /api/v2/cases/{id}/docs:
    get:
      tags:
        - Cases
      summary: List case documents
      description: >-
        Returns all documents associated with a specific case, with optional
        filtering by category.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
          description: Case ID
        - in: query
          name: category
          schema:
            type: string
            enum:
              - General
              - ClientInformation
              - OfficialDocuments
              - ProtocolAndEnquiryForms
              - ProtocolFormsEvidence
              - EnquiryFormsEvidence
              - AdditionalDocuments
          description: Filter documents by category
      responses:
        '200':
          description: List of case documents
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: Document ID
                    category:
                      type: string
                      enum:
                        - General
                        - ClientInformation
                        - OfficialDocuments
                        - ProtocolAndEnquiryForms
                        - ProtocolFormsEvidence
                        - EnquiryFormsEvidence
                        - AdditionalDocuments
                      description: Document category
                    fileName:
                      type: string
                      description: Document title/filename
                    status:
                      type: string
                      enum:
                        - Uploaded
                        - addLater
                        - notAvailable
                        - HMLRPending
                        - YOTIPending
                        - SearchBureauPending
                        - OneSearchPending
                      description: Document status
                    dateUploaded:
                      type:
                        - string
                        - 'null'
                      format: date-time
                      description: Date and time when document was uploaded
                    url:
                      type:
                        - string
                        - 'null'
                      description: Upload URL (if uploaded)
                    mimeType:
                      type:
                        - string
                        - 'null'
                      description: MIME type of the document
                    fileSizeBytes:
                      type:
                        - number
                        - 'null'
                      description: File size in bytes
                    createdAt:
                      type: string
                      format: date-time
                      description: Document creation timestamp
        '400':
          description: Bad request - missing case ID or invalid category
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message
        '401':
          description: Unauthorized - user not authenticated
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message
        '403':
          description: Forbidden - user doesn't belong to the organization
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message
        '404':
          description: Case not found or doesn't belong to organization
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Error message

````