Skip to main content
POST
Create a case

Authorizations

Authorization
string
header
required

API key authentication. Use format: Authorization: Bearer tavrn_sk_live_...

Body

application/json
title
string
required

Case title

Required string length: 1 - 500
Example:

"Jane Doe v. ACME Corp"

client_name
string
required

Client's name

Required string length: 1 - 200
Example:

"Jane Doe"

description
string

Case description

Maximum string length: 5000
client_date_of_birth
string<date>

Client's date of birth (YYYY-MM-DD)

client_address
string

Client's address

Maximum string length: 500
client_phone
string

Client's phone number

Maximum string length: 50
client_email
string<email>

Client's email address

date_of_injury
string<date>

Date of injury (YYYY-MM-DD, must be in the past)

deposition_date
string<date>

Deposition date (YYYY-MM-DD)

case_category
enum<string>
default:personal_injury

Case category (defaults to personal_injury)

Available options:
personal_injury,
motor_vehicle_accident,
medical_malpractice,
workers_compensation,
product_liability,
premises_liability,
wrongful_death,
other
status
enum<string>
default:active

Case status (defaults to active)

Available options:
active,
pending,
closed
external_id
string

External identifier for client mapping

Maximum string length: 255

Response

Case created successfully

id
string
required

Unique case identifier

Example:

"case_abc123"

case_number
string
required

Auto-generated case number

Example:

"EI-2025-0001"

title
string
required

Case title

Example:

"Jane Doe v. ACME Corp"

client_name
string
required

Client's name

Example:

"Jane Doe"

case_category
enum<string>
required

Case category

Available options:
personal_injury,
motor_vehicle_accident,
medical_malpractice,
workers_compensation,
product_liability,
premises_liability,
wrongful_death,
other
Example:

"personal_injury"

status
enum<string>
required

Case status

Available options:
active,
pending,
closed,
archived
Example:

"active"

created_at
string<date-time>
required

Creation timestamp (ISO 8601)

Example:

"2025-02-01T12:34:56Z"

updated_at
string<date-time>
required

Last update timestamp (ISO 8601)

Example:

"2025-02-01T12:34:56Z"

description
string | null

Case description

Example:

"Rear-end MVA with cervical injury"

client_date_of_birth
string<date> | null

Client's date of birth (YYYY-MM-DD)

Example:

"1989-04-12"

client_address
string | null

Client's address

Example:

"123 Main St, Austin, TX 78701"

client_phone
string | null

Client's phone number

Example:

"+1-512-555-0101"

client_email
string<email> | null

Client's email address

Example:

"jane@example.com"

date_of_injury
string<date> | null

Date of injury (YYYY-MM-DD)

Example:

"2025-01-10"

deposition_date
string<date> | null

Deposition date (YYYY-MM-DD)

Example:

"2025-06-15"

external_id
string | null

External identifier for client mapping

Example:

"expert-institute-12345"