Creating matters

Use the following endpoint to create a matter for a given claim:

POST /claim/v1/claims/{claimId}/matters

You can POST matters only on open claims. You cannot POST matters on draft claims.

Minimum creation criteria

The only required field is the matter's name.

For example, the following request creates a matter for claim demo_sample:1 using only the required field.

POST /claim/v1/claims/demo_sample:1/matters/

{
  "data": {
    "attributes": {
        "name": "Claim arbitration"
    }
  }
}

The following request creates a matter for claim demo_sample:1 using the required field and some of the optional fields.

POST /claim/v1/claims/demo_sample:1/matters/

{
  "data": {
    "attributes": {
        "caseNumber": "35-00341B",
        "fileDate": "2023-02-02",
        "matterType": {
            "code": "Mediation"
        },
        "name": "Mediation to determine who was at fault"
    }
  }
}