Compliance Cases

A case represents a compliance issue Modern Treasury needs you to resolve before verification of a Legal Entity can finish. When an automated compliance check fails during onboarding, Modern Treasury opens a Case on the Legal Entity and records one or more requested_actions describing the information you must provide.

Cases are read-only. You resolve a Case by supplying the requested information on the Legal Entity — either by updating the Legal Entity or by uploading a Document to it. Each submission re-runs the failed compliance checks; when every requested action has been resolved the Case status becomes resolved.

You can also view a Legal Entity's Cases and their requested actions in the Cases tab of the Legal Entity page in the Modern Treasury dashboard.

Subscribe to Case webhooks to be notified when a Case is opened, updated, or resolved.

The Case object

Attribute	Description
id string	Unique identifier for the Case.
object string	Always `case`.
live_mode boolean	This field will be `true` if this object exists in the live environment, or `false` if it exists in the test environment.
status string	The status of the Case. One of: `open` or `resolved`.
subject_type string	The type of the object the Case is about. Currently always `legal_entity`.
subject_id string	The ID of the object the Case is about.
requested_actions array	The pending Requested Actions on the Case. These are the actions you still need to take to resolve the Case.
resolved_actions array	The Requested Actions on the Case that have already been resolved.
created_at string	The time at which the Case was created.
updated_at string	The time at which the Case was last updated.

The Requested Action object

Attribute	Description
id string	Unique identifier for the Requested Action.
object string	Always `requested_action`.
live_mode boolean	This field will be `true` if this object exists in the live environment, or `false` if it exists in the test environment.
category string	The category of the Requested Action. See Requested Action categories below.
field string	The field that needs to be corrected or provided, if any. One of: `articles_of_incorporation`, `ein_letter`, `legal_entity_details`, or `proof_of_address`.
instructions string	Human-readable instructions on how to resolve the Requested Action.
reasons array	The reasons the action was requested. See Requested Action reasons below.
created_at string	The time at which the Requested Action was created.
updated_at string	The time at which the Requested Action was last updated.

Requested Action categories

Category	Field	How to resolve
`onboarding_proof_of_address_failure`	`proof_of_address`	Upload a `proof_of_address` document dated within the last 90 days to the Legal Entity.
`onboarding_business_registry_verification_failure`	`articles_of_incorporation`	Upload an `articles_of_incorporation` document showing the business name, registration number, and address to the Legal Entity.
`onboarding_tin_check_failure`	`ein_letter`	Upload an `ein_letter` document showing the legal name and taxpayer identification number, or correct the EIN on the Legal Entity's identification.
`onboarding_ssn_check_failure`	`legal_entity_details`	Confirm and, if needed, correct the individual's legal name and social security number on the Legal Entity.

Requested Action reasons

Reason	Description
`document_out_of_date`	The document is too old, or no issue date could be read from it.
`document_incorrect_type`	The document is not of the type required for this check.
`malformed_content_type`	The document could not be trusted, for example because it appears to have been edited or annotated.
`identity_unverified`	The submitted details could not be matched against an authoritative source.

Example Case

{
  "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"
}