---
title: "List Cases"
method: GET
path: "/"
tags: ["Cases"]
---

# List Cases

`GET /`

## Request

- Base URL: `https://app2test.infiniaweb.com/infinia_api/v1/cases`
- URL: `https://app2test.infiniaweb.com/infinia_api/v1/cases/`
- Auth: HTTP basic

Returns a paginated list of your cases, newest first. `status` tells you who has to act next; use `reference_url` to open the support ticket and answer.

## Query parameters

- `status` 'AWAITING_CUSTOMER' | 'AWAITING_INFINIA' | 'RESOLVED' | 'CANCELLED'
- `category` 'RFI' | 'FRAUD' | 'MISTAKE'
- `reference` string: Support ticket reference (exact match).
- `due_from` string, date-time: Only include cases due on or after this timestamp. ISO 8601 (UTC), applied to `due_at`.
- `due_to` string, date-time: Only include cases due on or before this timestamp. ISO 8601 (UTC), applied to `due_at`.
- `date_from` string, date-time: Only include cases created on or after this timestamp. ISO 8601 (UTC), applied to `created_at`.
- `date_to` string, date-time: Only include cases created on or before this timestamp. ISO 8601 (UTC), applied to `created_at`.
- `operation_id` string: Only include cases about this operation: a payout, pay-in or internal transfer ID. Also matches cases that reference any movement of that operation.
- `movement_id` integer: Only include cases about this movement, or about the payout, pay-in or internal transfer it belongs to.
- `include_child_companies` boolean: If set to true, also include cases belonging to any child companies of the authenticated company. Default: false.
- `limit` integer
- `cursor` string

## Headers

- `x-company-id` integer: ID of a child company for authentication. If not provided, the parent company will be authenticated.

## Response `200`

Successful Response

- SuccessListCaseResponse
  - `next_cursor` string
  - `has_more` boolean
  - `status` 'success'
  - `data` PublicCaseDto[], required
    - `id` string, required: Case ID
    - `company_id` integer, required
    - `title` string, required
    - `description` string, required
    - `category` 'RFI' | 'FRAUD' | 'MISTAKE', required
    - `status` 'AWAITING_CUSTOMER' | 'AWAITING_INFINIA' | 'RESOLVED' | 'CANCELLED', required
    - `is_overdue` boolean, required: True while the case is open and due_at is in the past.
    - `due_at` string, date-time: Deadline (UTC).
    - `reference` string, required: Support ticket reference.
    - `reference_url` string, required: Link to the support ticket where the case is discussed and answered.
    - `resources` CaseResourceRef[]: Related resources: the resources, accounts or account owners the case is about.
      - `type` 'PAYOUT' | 'PAYIN' | 'INTERNAL_TRANSFER' | 'MOVEMENT' | 'ACCOUNT' | 'ACCOUNT_OWNER', required: What a case can be about: a transaction, an account or an account owner.
      - `id` string, required: Payout, payin, internal transfer or account owner ID (uuid), or movement / account ID.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `closed_at` string, date-time

## Other responses

- `400`: Bad Request
- `422`: Validation Error
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infiniaweb/apis/cases.md) - [All operations](https://skmtc.dev/infiniaweb/apis/cases/llms.txt) - [OpenAPI document](https://skmtc.dev/infiniaweb/apis/cases/revisions/5474062c4dc1?raw)
