> ## 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. # Acknowledge a case > Marks a SENT case as acknowledged by the receiving firm, transitioning it to RECEIVED. Requires STANDARD tier. ## OpenAPI ````yaml /api-reference/openapi.yml post /cases/{id}/acknowledge 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: /cases/{id}/acknowledge: post: tags: - Cases summary: Acknowledge a case description: >- Marks a SENT case as acknowledged by the receiving firm, transitioning it to RECEIVED. Requires STANDARD tier. operationId: acknowledgeCase parameters: - in: path name: id required: true schema: type: string format: uuid description: Resource UUID responses: '200': description: Acknowledged case content: application/json: schema: type: object properties: data: $ref: '#/components/schemas/Case' meta: type: object properties: requestId: type: string example: req_f2dbe1d3f6ad4a7bb5b4c9f2 timestamp: type: string format: date-time required: - requestId - timestamp required: - data - 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 security: - apiKeyAuth: [] components: schemas: Case: type: object properties: id: type: string format: uuid referenceNumber: type: string example: ABC-0001 title: type: string description: type: string nullable: true status: type: string description: CaseStatus enum value caseType: type: string jurisdiction: type: string county: type: string nullable: true clientFirstName: type: string clientLastName: type: string clientEmail: type: string format: email nullable: true clientPhone: type: string nullable: true incidentDate: type: string format: date nullable: true notes: type: string nullable: true sendingFirmId: type: string format: uuid receivingFirmId: type: string format: uuid nullable: true createdAt: type: string format: date-time updatedAt: type: string format: date-time securitySchemes: apiKeyAuth: type: apiKey in: header name: X-API-Key description: Public API key (starts with cxp_). Required on every request. ````