---
updatedAt: 2026-08-28T18:30:11.000Z
agentTools:
  projectIndex: https://docs.moderntreasury.com/platform/llms.txt
---

# List Cases

Get a list of Cases. Cases are read-only; resolve one by supplying the information named in its `requested_actions`.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "modern-treasury-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://app.moderntreasury.com/api"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/cases": {
      "get": {
        "summary": "List Cases",
        "description": "Get a list of Cases. Cases are read-only; resolve one by supplying the information named in its `requested_actions`.",
        "operationId": "list-cases",
        "parameters": [
          {
            "name": "status",
            "in": "query",
            "description": "The status of the Case.",
            "schema": {
              "type": "string",
              "enum": [
                "open",
                "resolved"
              ]
            }
          },
          {
            "name": "subject_id",
            "in": "query",
            "description": "The ID of the object the Case is about, for example a legal entity ID.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "subject_type",
            "in": "query",
            "description": "The type of the object the Case is about.",
            "schema": {
              "type": "string",
              "enum": [
                "legal_entity"
              ]
            }
          },
          {
            "name": "after_cursor",
            "in": "query",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "per_page",
            "in": "query",
            "schema": {
              "type": "integer",
              "format": "int32",
              "default": 25
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": [
                      {
                        "id": "b7d0a9f4-1f2c-4c2e-9b3a-5f1d1c6e0f21",
                        "object": "case",
                        "live_mode": true,
                        "status": "open",
                        "subject_type": "legal_entity",
                        "subject_id": "7d885cb7-6cad-42ab-ae01-d61bb90b4780",
                        "requested_actions": [
                          {
                            "id": "42e79631-195e-40d4-963f-e86b2facbc19",
                            "object": "requested_action",
                            "live_mode": true,
                            "category": "onboarding_proof_of_address_failure",
                            "field": "proof_of_address",
                            "instructions": "Upload a proof_of_address document dated within the last 90 days to the legal entity using the documents endpoint.",
                            "reasons": [
                              "document_out_of_date"
                            ],
                            "created_at": "2026-08-20T20:13:46Z",
                            "updated_at": "2026-08-20T20:13:46Z"
                          }
                        ],
                        "resolved_actions": [],
                        "created_at": "2026-08-20T20:13:46Z",
                        "updated_at": "2026-08-20T20:13:46Z"
                      }
                    ]
                  }
                },
                "schema": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string",
                        "example": "b7d0a9f4-1f2c-4c2e-9b3a-5f1d1c6e0f21"
                      },
                      "object": {
                        "type": "string",
                        "example": "case"
                      },
                      "live_mode": {
                        "type": "boolean",
                        "example": true
                      },
                      "status": {
                        "type": "string",
                        "description": "The status of the case.",
                        "enum": [
                          "open",
                          "resolved"
                        ],
                        "example": "open"
                      },
                      "subject_type": {
                        "type": "string",
                        "description": "The type of the object the case is about.",
                        "enum": [
                          "legal_entity"
                        ],
                        "example": "legal_entity"
                      },
                      "subject_id": {
                        "type": "string",
                        "description": "The ID of the object the case is about.",
                        "example": "7d885cb7-6cad-42ab-ae01-d61bb90b4780"
                      },
                      "requested_actions": {
                        "type": "array",
                        "description": "The pending actions requested to resolve the case.",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "example": "42e79631-195e-40d4-963f-e86b2facbc19"
                            },
                            "object": {
                              "type": "string",
                              "example": "requested_action"
                            },
                            "live_mode": {
                              "type": "boolean",
                              "example": true
                            },
                            "category": {
                              "type": "string",
                              "description": "The category of the requested action.",
                              "enum": [
                                "onboarding_articles_of_incorporation_failure",
                                "onboarding_business_registry_verification_failure",
                                "onboarding_database_failure",
                                "onboarding_proof_of_address_failure",
                                "onboarding_ssn_check_failure",
                                "onboarding_tin_check_failure"
                              ],
                              "example": "onboarding_proof_of_address_failure"
                            },
                            "field": {
                              "type": "string",
                              "nullable": true,
                              "description": "The field that needs to be corrected or provided, if any.",
                              "enum": [
                                "articles_of_incorporation",
                                "ein_letter",
                                "legal_entity_details",
                                "proof_of_address"
                              ],
                              "example": "proof_of_address"
                            },
                            "instructions": {
                              "type": "string",
                              "nullable": true,
                              "description": "Instructions on how to resolve the requested action.",
                              "example": "Upload a proof_of_address document dated within the last 90 days to the legal entity using the documents endpoint."
                            },
                            "reasons": {
                              "type": "array",
                              "description": "The reasons the action was requested.",
                              "items": {
                                "type": "string"
                              },
                              "example": [
                                "document_out_of_date"
                              ]
                            },
                            "created_at": {
                              "type": "string",
                              "format": "date-time",
                              "example": "2026-08-20T20:13:46Z"
                            },
                            "updated_at": {
                              "type": "string",
                              "format": "date-time",
                              "example": "2026-08-20T20:13:46Z"
                            }
                          }
                        }
                      },
                      "resolved_actions": {
                        "type": "array",
                        "description": "The requested actions that have been resolved.",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "example": "42e79631-195e-40d4-963f-e86b2facbc19"
                            },
                            "object": {
                              "type": "string",
                              "example": "requested_action"
                            },
                            "live_mode": {
                              "type": "boolean",
                              "example": true
                            },
                            "category": {
                              "type": "string",
                              "description": "The category of the requested action.",
                              "enum": [
                                "onboarding_articles_of_incorporation_failure",
                                "onboarding_business_registry_verification_failure",
                                "onboarding_database_failure",
                                "onboarding_proof_of_address_failure",
                                "onboarding_ssn_check_failure",
                                "onboarding_tin_check_failure"
                              ],
                              "example": "onboarding_proof_of_address_failure"
                            },
                            "field": {
                              "type": "string",
                              "nullable": true,
                              "description": "The field that needs to be corrected or provided, if any.",
                              "enum": [
                                "articles_of_incorporation",
                                "ein_letter",
                                "legal_entity_details",
                                "proof_of_address"
                              ],
                              "example": "proof_of_address"
                            },
                            "instructions": {
                              "type": "string",
                              "nullable": true,
                              "description": "Instructions on how to resolve the requested action.",
                              "example": "Upload a proof_of_address document dated within the last 90 days to the legal entity using the documents endpoint."
                            },
                            "reasons": {
                              "type": "array",
                              "description": "The reasons the action was requested.",
                              "items": {
                                "type": "string"
                              },
                              "example": [
                                "document_out_of_date"
                              ]
                            },
                            "created_at": {
                              "type": "string",
                              "format": "date-time",
                              "example": "2026-08-20T20:13:46Z"
                            },
                            "updated_at": {
                              "type": "string",
                              "format": "date-time",
                              "example": "2026-08-20T20:13:46Z"
                            }
                          }
                        }
                      },
                      "created_at": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2026-08-20T20:13:46Z"
                      },
                      "updated_at": {
                        "type": "string",
                        "format": "date-time",
                        "example": "2026-08-20T20:13:46Z"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```