List cases

GET

/v2/cases/organization/:organizationId

GET

/api/v2/cases/organization/:organizationId

curl -G https://api-sandbox.payabli.com/api/v2/cases/organization/123 \
     -H "Authorization: Bearer <token>" \
     -d fromRecord=0 \
     -d limitRecord=20

{
  "summary": {
    "totalRecords": 1,
    "totalAmount": 0,
    "totalNetAmount": 0,
    "totalPages": 1,
    "pageSize": 20,
    "pageidentifier": null
  },
  "records": [
    {
      "uuid": "9c2b7e14-3a5f-4d21-b8e0-1f6a4c9d2e70",
      "state": "PendingCompletion",
      "caseType": "BankAccountChange",
      "parameters": {
        "type": "BankAccountChange",
        "nickname": "Main Settlement Account",
        "bankName": "First National Bank",
        "bankToken": "bnk_2b1c9e40f5a34c9a8f219e7c6b1a2d34",
        "accountType": "Checking",
        "bankAccountHolderName": "Gruzya Adventure Outfitters LLC",
        "bankAccountHolderType": "business",
        "bankAccountFunction": "Deposits",
        "services": {
          "moneyIn": [
            "Ach"
          ],
          "moneyOut": [
            "Ach"
          ]
        },
        "default": true
      },
      "orgId": 123,
      "paypointId": 3040,
      "scheduleFor": null,
      "createdAt": "2026-01-15T10:30:00Z",
      "updatedAt": "2026-01-15T10:30:43Z",
      "createdBy": 0,
      "assigneeId": null,
      "lastReviewedById": null,
      "stateHistory": [],
      "attachments": [],
      "roomId": 96369,
      "metadata": null,
      "org": {
        "id": 123,
        "name": "Example Partner Org"
      },
      "paypoint": {
        "id": 3040,
        "name": "Gruzya Adventure Outfitters"
      },
      "createdByUser": null,
      "assignee": null,
      "lastReviewedBy": null
    }
  ]
}

Lists cases for an organization, climbing the platform org hierarchy. Supports pagination and sorting through query parameters, and filtering through repeatable parameters[field(op)]=value query parameters (for example parameters[state(in)]=Assigned|PendingReview). Filterable fields include state, caseType, paypointId, createdAt, updatedAt, scheduleFor, and createdBy.

Available to both Platform and Enterprise Partners.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

organizationIdlongRequired

The organization's numeric identifier.

Query parameters

fromRecordintegerOptionalDefaults to 0

The zero-based index of the first record to return.

limitRecordintegerOptional<=200Defaults to 50

The maximum number of records to return (1 to 200).

sortBystringOptional

Sort expression, such as desc(createdAt) or asc(state). Defaults to desc(createdAt).

Response

A page of cases

summaryobject

Pagination and totals for a case list response.

recordslist of objects

The cases on this page. Each record is a full case object.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

500

Internal Server Error