Skip to main content

​
Documents Endpoints

Base URL: https://api.casexchange.com/api/public/v1

​
GET /cases//documents

Returns all documents attached to the specified case. Tier: read_only 
curl -X GET "https://api.casexchange.com/api/public/v1/cases/d3f8a1b2-4c56-7def-8901-abcdef234567/documents" \
  -H "X-API-Key: cxp_ro_your_key_here"
Response 200 
{
  "data": [
    {
      "id": "e4a91c2d-5b67-8f09-a1b2-c3d4e5f60718",
      "caseId": "d3f8a1b2-4c56-7def-8901-abcdef234567",
      "fileName": "medical-records-2025.pdf",
      "mimeType": "application/pdf",
      "sizeBytes": 2458190,
      "uploadedBy": "jthompson@sterlinglaw.example.com",
      "createdAt": "2026-02-14T10:32:00.000Z"
    },
    {
      "id": "f5b02d3e-6c78-9a10-b2c3-d4e5f6a71829",
      "caseId": "d3f8a1b2-4c56-7def-8901-abcdef234567",
      "fileName": "police-report-incident-4491.pdf",
      "mimeType": "application/pdf",
      "sizeBytes": 874520,
      "uploadedBy": "mreeves@sterlinglaw.example.com",
      "createdAt": "2026-02-15T14:05:00.000Z"
    }
  ],
  "meta": {
    "requestId": "req_3a7b8c9d0e1f2345",
    "timestamp": "2026-03-31T16:00:00.000Z"
  }
}

​
POST /cases//documents

Uploads a file and attaches it to the specified case. Accepts multipart/form-data. Maximum file size is 50 MB. Tier: standard 
curl -X POST "https://api.casexchange.com/api/public/v1/cases/d3f8a1b2-4c56-7def-8901-abcdef234567/documents" \
  -H "X-API-Key: cxp_std_your_key_here" \
  -F "file=@document.pdf"
Response 201 
{
  "data": {
    "id": "a6c13e4f-7d89-0b21-c3d4-e5f6a7b83940",
    "caseId": "d3f8a1b2-4c56-7def-8901-abcdef234567",
    "fileName": "document.pdf",
    "mimeType": "application/pdf",
    "sizeBytes": 1048576,
    "uploadedBy": "jthompson@sterlinglaw.example.com",
    "createdAt": "2026-03-31T16:01:00.000Z"
  },
  "meta": {
    "requestId": "req_4b8c9d0e1f234567",
    "timestamp": "2026-03-31T16:01:00.000Z"
  }
}

​
GET /cases//documents//download

Returns a short-lived pre-signed S3 URL for downloading the specified document. Tier: read_only 
curl -X GET "https://api.casexchange.com/api/public/v1/cases/d3f8a1b2-4c56-7def-8901-abcdef234567/documents/e4a91c2d-5b67-8f09-a1b2-c3d4e5f60718/download" \
  -H "X-API-Key: cxp_ro_your_key_here"
Response 200 
{
  "data": {
    "downloadUrl": "https://casexchange-documents.s3.amazonaws.com/d3f8a1b2-4c56-7def-8901-abcdef234567/e4a91c2d-5b67-8f09-a1b2-c3d4e5f60718/medical-records-2025.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=EXAMPLE&X-Amz-Expires=3600&X-Amz-Signature=EXAMPLE",
    "fileName": "medical-records-2025.pdf"
  },
  "meta": {
    "requestId": "req_5c9d0e1f23456789",
    "timestamp": "2026-03-31T16:02:00.000Z"
  }
}

​
DELETE /cases//documents/

Permanently deletes the specified document from the case and S3. Tier: full 
curl -X DELETE "https://api.casexchange.com/api/public/v1/cases/d3f8a1b2-4c56-7def-8901-abcdef234567/documents/f5b02d3e-6c78-9a10-b2c3-d4e5f6a71829" \
  -H "X-API-Key: cxp_full_your_key_here"
Response 204 No Content No response body.