> ## Documentation Index > Fetch the complete documentation index at: https://docs.casexchange.com/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a MedEx case document > Returns a short-lived presigned S3 URL by default (?format=url), or the document inline as base64 (?format=base64, capped at 20 MB raw). Files over the cap must use ?format=url. ## OpenAPI ````yaml /api-reference/openapi.yml get /med-cases/{caseId}/documents/{documentId} openapi: 3.0.3 info: title: CaseXchange Public API version: 1.0.0 description: >- The CaseXchange Public API enables law firms to integrate referral management directly into their own systems. ## Authentication All requests must include an `X-API-Key` header containing a valid API key (format: `cxp_`). Keys are scoped to a firm and an access tier. ## Access Tiers | Tier | Description | |------|-------------| | `read_only` | GET endpoints — read data without mutation | | `standard` | read_only + create/update case referrals | | `full` | standard + delete, routing rules, bulk import, firm mutation | ## Rate Limiting Rate limits are enforced per API key. Exceeded limits return `429 Too Many Requests`. ## Pagination List endpoints accept `page` (default 1) and `limit` (default 20, max 100) query params. ## Response Format Successful responses are wrapped in `{ data: T, meta: { requestId, timestamp } }`. Errors are wrapped in `{ error: { code, message }, meta: { requestId, timestamp } }`. contact: name: CaseXchange API Support url: https://casexchange.com servers: - url: https://api.casexchange.com/api/public/v1 description: Production Public API base path - url: /api/public/v1 description: Relative base path (for proxied docs/local environments) security: [] tags: - name: Reference Data description: Case types, jurisdictions, and counties - name: Firms description: Firm directory and profile management - name: Cases description: Case referral lifecycle and actions - name: Sent Cases description: 'Sender-side case management: create, track, and refer/route cases you own' - name: Documents description: Document upload, download, and management - name: Users description: User management within the caller's firm - name: Routing description: Referral routing rules - name: Analytics description: Dashboard and case analytics - name: Notifications description: Notification preferences and email management - name: Med Cases description: Med Xchange cases and their nested referrals to medical providers - name: MedEx Documents description: Med Xchange case document listing and download - name: Import description: Bulk case import/update via CSV - name: Salesforce description: Org-facing endpoints consumed by the CaseXchange managed package paths: /med-cases/{caseId}/documents/{documentId}: get: tags: - MedEx Documents summary: Retrieve a MedEx case document description: >- Returns a short-lived presigned S3 URL by default (?format=url), or the document inline as base64 (?format=base64, capped at 20 MB raw). Files over the cap must use ?format=url. operationId: getMedCaseDocument parameters: - in: path name: caseId required: true schema: type: string format: uuid description: MedCase UUID - in: path name: documentId required: true schema: type: string format: uuid description: Document handle (junction id) - in: query name: format required: false schema: type: string enum: - url - base64 default: url responses: '200': description: Presigned URL (default) or base64 document content: application/json: schema: type: object properties: data: oneOf: - type: object properties: id: type: string fileName: type: string contentType: type: string fileSize: type: integer downloadUrl: type: string format: uri expiresAt: type: string format: date-time - type: object properties: id: type: string fileName: type: string contentType: type: string fileSize: type: integer encoding: type: string enum: - base64 data: type: string meta: type: object properties: requestId: type: string example: req_f2dbe1d3f6ad4a7bb5b4c9f2 timestamp: type: string format: date-time required: - requestId - timestamp required: - data - meta '400': description: Request validation failed content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string required: - code - message meta: type: object properties: requestId: type: string example: req_f2dbe1d3f6ad4a7bb5b4c9f2 timestamp: type: string format: date-time required: - requestId - timestamp required: - error - meta '401': description: Invalid or missing API key content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string required: - code - message meta: type: object properties: requestId: type: string example: req_f2dbe1d3f6ad4a7bb5b4c9f2 timestamp: type: string format: date-time required: - requestId - timestamp required: - error - meta '403': description: API key tier does not permit this action content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string required: - code - message meta: type: object properties: requestId: type: string example: req_f2dbe1d3f6ad4a7bb5b4c9f2 timestamp: type: string format: date-time required: - requestId - timestamp required: - error - meta '404': description: Resource not found content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string required: - code - message meta: type: object properties: requestId: type: string example: req_f2dbe1d3f6ad4a7bb5b4c9f2 timestamp: type: string format: date-time required: - requestId - timestamp required: - error - meta '413': description: Document too large to inline as base64; use ?format=url. content: application/json: schema: type: object properties: error: type: object properties: code: type: string message: type: string required: - code - message meta: type: object properties: requestId: type: string example: req_f2dbe1d3f6ad4a7bb5b4c9f2 timestamp: type: string format: date-time required: - requestId - timestamp required: - error - meta security: - apiKeyAuth: [] components: securitySchemes: apiKeyAuth: type: apiKey in: header name: X-API-Key description: Public API key (starts with cxp_). Required on every request. ````