---
title: "findCaseById"
method: GET
path: "/cases/{caseId}"
tags: ["case-endpoint"]
---

# findCaseById

`GET /cases/{caseId}`

find a case and it's case events by an id.

## Path parameters

- `caseId` string, required

## Query parameters

- `caseevents` boolean
- `iac` boolean

## Response `200`

OK

- CaseDetailsDTO
  - `actionPlanId` string
  - `caseEvents` CaseEventDTO[]
    - `category` 'ACCESS_CODE_AUTHENTICATION_ATTEMPT' | 'ACTION_CANCELLATION_COMPLETED' | 'ACTION_CANCELLATION_CREATED' | 'ACTION_COMPLETED' | 'ACTION_CREATED' | 'ACTION_UPDATED' | 'ADDRESS_OCCUPIED_NO_RESIDENT' | 'CASE_CREATED' | 'COLLECTION_INSTRUMENT_DOWNLOADED' | 'COLLECTION_INSTRUMENT_ERROR' | 'COMPLETED_BY_PHONE' | 'COMPLY_IN_DIFFERENT_COLLECTION_MODE' | 'DISABLE_RESPONDENT_ENROLMENT' | 'EQ_LAUNCH' | 'GENERATE_ENROLMENT_CODE' | 'LACK_OF_COMPUTER_INTERNET_ACCESS' | 'NO_ACTIVE_ENROLMENTS' | 'NO_LONGER_REQUIRED' | 'OFFLINE_RESPONSE_PROCESSED' | 'ONLINE_QUESTIONNAIRE_RESPONSE' | 'PHYSICALLY_OR_MENTALLY_UNABLE' | 'PRIVACY_DATA_CONFIDENTIALITY_CONCERNS' | 'RESPONDENT_ACCOUNT_CREATED' | 'RESPONDENT_EMAIL_AMENDED' | 'RESPONDENT_ENROLED' | 'SECURE_MESSAGE_SENT' | 'SUCCESSFUL_RESPONSE_UPLOAD' | 'UNSUCCESSFUL_RESPONSE_UPLOAD' | 'VERIFICATION_CODE_SENT'
    - `createdBy` string
    - `createdDateTime` string, date-time
    - `description` string
    - `metadata` object
    - `subCategory` string
  - `caseGroup` CaseGroupDTO
    - `caseGroupStatus` 'NOTSTARTED' | 'INPROGRESS' | 'COMPLETE' | 'COMPLETEDBYPHONE' | 'REOPENED' | 'NOLONGERREQUIRED' | 'REFUSAL' | 'OTHERNONRESPONSE' | 'UNKNOWNELIGIBILITY' | 'NOTELIGIBLE'
    - `collectionExerciseId` string
    - `id` string
    - `partyId` string
    - `sampleUnitRef` string
    - `sampleUnitType` string
    - `surveyId` string
  - `caseRef` string
  - `collectionInstrumentId` string
  - `createdBy` string
  - `createdDateTime` string, date-time
  - `iac` string
  - `id` string
  - `partyId` string
  - `sampleUnitId` string
  - `sampleUnitType` string
  - `state` 'ACTIONABLE' | 'INACTIONABLE' | 'REPLACEMENT_INIT' | 'SAMPLED_INIT'

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/office-of-national-statistics/apis/case-service-api.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/case-service-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/case-service-api/revisions/dcc0c657a75b/schema)