Case Evidence

Case evidence tracks exhibits and testimonial evidence submitted by plaintiffs, defendants, and counsels against a case record.

The case evidence model

Name
id
Type
string
Description
Unique UUID identifier for the evidence.
Name
case_record_id
Type
string
Description
The case record this evidence belongs to.
Name
party_type
Type
string
Description
Which party submitted the evidence, e.g. Plaintiff, Defendant.
Name
exhibit
Type
string
Description
The exhibit label, e.g. "Exhibit A".
Name
description
Type
string
Description
Description of the evidence. Required for non-testimonial evidence types.
Name
witness_name
Type
string | null
Description
Name of the witness. Required when the evidence category is Testimonial.
Name
category
Type
string
Description
Evidence category, e.g. Documentary, Object, Testimonial.
Name
submarking
Type
array | null
Description
Sub-markings under this exhibit (e.g. Exhibit A-1, A-2), added via the submarking endpoints below.
Name
created_at
Type
timestamp
Description
Timestamp when the evidence was created.
Name
updated_at
Type
timestamp
Description
Timestamp when the evidence was last updated.

GET/api/case/{case}/evidence-list

List evidence for a case

Retrieve all evidence submitted for a case record.

Path parameters

Name
case
Type
string
Description
The UUID of the case record.

Request

GET

/api/case/{case}/evidence-list

curl https://your-domain.com/api/case/a1b2c3d4-e5f6-7890-abcd-ef1234567890/evidence-list \
  -H "Accept: application/json" \
  -H "X-XSRF-TOKEN: {token}" \
  --cookie "cms_admin_session={session}"

Response

{
  "data": [
    {
      "id": "f0e1d2c3-b4a5-6789-0fed-cba987654321",
      "party_type": "Plaintiff",
      "exhibit": "Exhibit A",
      "description": "Promissory note dated 2025-01-15",
      "category": "Documentary",
      "created_at": "2026-02-12T10:00:00+00:00"
    }
  ]
}

POST/api/case/{case}/evidence

Add evidence to a case

Submit a new piece of evidence for a case record.

Path parameters

Name
case
Type
string
Description
The UUID of the case record.

Required attributes

Name
party_type
Type
string
Description
Which party is submitting, e.g. Plaintiff, Defendant.
Name
category
Type
string
Description
One of Documentary, Object, Testimonial.
Name
exhibit
Type
string
Description
Required unless category is Testimonial.
Name
description
Type
string
Description
Required unless category is Testimonial.
Name
witness_name
Type
string
Description
Required when category is Testimonial.

Request

POST

/api/case/{case}/evidence

curl -X POST https://your-domain.com/api/case/a1b2c3d4-e5f6-7890-abcd-ef1234567890/evidence \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-XSRF-TOKEN: {token}" \
  --cookie "cms_admin_session={session}" \
  -d '{
    "party_type": "Plaintiff",
    "category": "Documentary",
    "exhibit": "Exhibit A",
    "description": "Promissory note dated 2025-01-15"
  }'

Response

{
  "data": {
    "id": "f0e1d2c3-b4a5-6789-0fed-cba987654321",
    "party_type": "Plaintiff",
    "exhibit": "Exhibit A",
    "description": "Promissory note dated 2025-01-15",
    "category": "Documentary",
    "created_at": "2026-02-20T10:30:00+00:00"
  }
}

POST/api/case/{case}/evidence/add-submarking

Add a submarking to an exhibit

Add a sub-marking (e.g. Exhibit A-1) under an existing exhibit. Use add-multiple-submarking to add several sub-markings at once.

Required attributes

Name
evidence_id
Type
string
Description
The UUID of the parent evidence/exhibit.
Name
submarking
Type
string
Description
The sub-marking label, e.g. A-1.
Name
description
Type
string
Description
Description of the sub-marked item.

Request

POST

/api/case/{case}/evidence/add-submarking

curl -X POST https://your-domain.com/api/case/a1b2c3d4-e5f6-7890-abcd-ef1234567890/evidence/add-submarking \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -H "X-XSRF-TOKEN: {token}" \
  --cookie "cms_admin_session={session}" \
  -d '{
    "evidence_id": "f0e1d2c3-b4a5-6789-0fed-cba987654321",
    "submarking": "A-1",
    "description": "Signature page"
  }'

Response

{
  "data": {
    "id": "f0e1d2c3-b4a5-6789-0fed-cba987654321",
    "exhibit": "Exhibit A",
    "submarking": [
      {"label": "A-1", "description": "Signature page"}
    ]
  }
}

DELETE/api/case.evidence/{evidence}

Delete a piece of evidence

Remove a piece of evidence from a case record.

Path parameters

Name
evidence
Type
string
Description
The UUID of the evidence to delete.

Request

DELETE

/api/case.evidence/{evidence}

curl -X DELETE https://your-domain.com/api/case/a1b2c3d4-e5f6-7890-abcd-ef1234567890/evidence/f0e1d2c3-b4a5-6789-0fed-cba987654321 \
  -H "Accept: application/json" \
  -H "X-XSRF-TOKEN: {token}" \
  --cookie "cms_admin_session={session}"

Response

{
  "message": "Evidence deleted successfully."
}