Attorney endpoints

Called with an attorney token to review a case and record its steps. Today they act on test-mode cases, where a built-in reviewer uses them; a real case is handled by the attorney engaged for it and does not go through these endpoints. An API key cannot call them. Customers integrating the API do not need them; they are listed so the reference is complete.

The examples use https://api.evictionsapi.com and placeholder keys. Conventions shared by all endpoints (errors, idempotency, pagination) are in the API reference.

What is available todayYou can start a real eviction case with Evictions API for a rental property in any US state or DC. After you submit a case, we engage a licensed attorney in the property’s state for it and confirm by email. Nothing is served on a tenant or filed in court until that attorney has reviewed the case.The full statement

Endpoints

GET `/v1/attorney/queue`

Cases awaiting the attorney's review, and assigned cases that need attention

Authentication: Attorney token, as Authorization: Bearer eut_...

Responses

Status	Meaning	Body
200	Cases in notice or filing review, and open cases on hold or with a failed job, oldest first.	{ items: AttorneyQueueItem[] }
400	The request is invalid.	Error
401	The credential is missing or invalid.	Error
403	The credential is not allowed to do this.	Error
404	Not found.	Error
409	The request conflicts with the current state: for a case, it is not in a state that allows this, or its details were erased (`erased`); for an API key, a limit or the key in use.	Error
422	The case did not pass a check.	Error

Example

curl example for GET /v1/attorney/queue

curl https://api.evictionsapi.com/v1/attorney/queue \
  -H "Authorization: Bearer eut_..."

GET `/v1/attorney/cases/{id}`

A case with its documents, evidence, gate results, filings, service attempts and full audit trail; the access is audited

Authentication: Attorney token, as Authorization: Bearer eut_...

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	The case id.

Responses

Status	Meaning	Body
200	The case in attorney detail.	AttorneyCase
400	The request is invalid.	Error
401	The credential is missing or invalid.	Error
403	The credential is not allowed to do this.	Error
404	Not found.	Error
409	The request conflicts with the current state: for a case, it is not in a state that allows this, or its details were erased (`erased`); for an API key, a limit or the key in use.	Error
422	The case did not pass a check.	Error

Example

curl example for GET /v1/attorney/cases/{id}

curl https://api.evictionsapi.com/v1/attorney/cases/case_... \
  -H "Authorization: Bearer eut_..."

GET `/v1/attorney/cases/{id}/documents/{docId}`

Download a document; the access is audited

Authentication: Attorney token, as Authorization: Bearer eut_...

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	The case id.
`docId`	path	string	Yes	The document id.

Responses

Status	Meaning	Body
200	The document bytes.	binaryapplication/pdf
400	The request is invalid.	Error
401	The credential is missing or invalid.	Error
403	The credential is not allowed to do this.	Error
404	Not found.	Error
409	The request conflicts with the current state: for a case, it is not in a state that allows this, or its details were erased (`erased`); for an API key, a limit or the key in use.	Error
410	`erased`: the details of the case were erased, and the document's content with them.	Error
422	The case did not pass a check.	Error

Example

curl example for GET /v1/attorney/cases/{id}/documents/{docId}

curl https://api.evictionsapi.com/v1/attorney/cases/case_.../documents/doc_... \
  -H "Authorization: Bearer eut_..." \
  -o document.pdf

POST `/v1/attorney/cases/{id}/reviews`

Approve, reject or request changes, naming the document hashes reviewed

Authentication: Attorney token, as Authorization: Bearer eut_...

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	The case id.

Request body

JSON. Fields not listed are rejected.

Name	Type	Required	Description
`decision`	string	Yes	One of: "approve", "reject", "request_changes".
`notes`	string	No	1 to 5000 characters.
`documentHashes`	array of string	Yes	Up to 50 items.

Responses

Status	Meaning	Body
200	The case after the decision.	Case
400	The request is invalid.	Error
401	The credential is missing or invalid.	Error
403	The credential is not allowed to do this.	Error
404	Not found.	Error
409	The request conflicts with the current state: for a case, it is not in a state that allows this, or its details were erased (`erased`); for an API key, a limit or the key in use.	Error
422	The case did not pass a check.	Error

Example

curl example for POST /v1/attorney/cases/{id}/reviews

curl -X POST https://api.evictionsapi.com/v1/attorney/cases/case_.../reviews \
  -H "Authorization: Bearer eut_..." \
  -H "Content-Type: application/json" \
  -d '{
  "decision": "approve",
  "documentHashes": ["df75f3ea1d63370ba642bde84f53668817f063ac887beb86b8593d78cf5642b9"]
}'

POST `/v1/attorney/cases/{id}/outcomes`

Record a court outcome

Authentication: Attorney token, as Authorization: Bearer eut_...

Parameters

Name	In	Type	Required	Description
`id`	path	string	Yes	The case id.

Request body

JSON. The body is one of these shapes. Fields not listed are rejected.

When type is "hearing_scheduled"

Name	Type	Required	Description
`type`	string	Yes	Always "hearing_scheduled".
`date`	string	Yes	—

When type is "judgment"

Name	Type	Required	Description
`type`	string	Yes	Always "judgment".
`outcome`	string	Yes	One of: "plaintiff", "defendant", "dismissed".

When type is "writ_requested"

Name	Type	Required	Description
`type`	string	Yes	Always "writ_requested".

When type is "writ_issued"

Name	Type	Required	Description
`type`	string	Yes	Always "writ_issued".

When type is "closed"

Name	Type	Required	Description
`type`	string	Yes	Always "closed".

Responses

Status	Meaning	Body
200	The case after the outcome.	Case
400	The request is invalid.	Error
401	The credential is missing or invalid.	Error
403	The credential is not allowed to do this.	Error
404	Not found.	Error
409	The request conflicts with the current state: for a case, it is not in a state that allows this, or its details were erased (`erased`); for an API key, a limit or the key in use.	Error
422	The case did not pass a check.	Error

Example

curl example for POST /v1/attorney/cases/{id}/outcomes

curl -X POST https://api.evictionsapi.com/v1/attorney/cases/case_.../outcomes \
  -H "Authorization: Bearer eut_..." \
  -H "Content-Type: application/json" \
  -d '{ "type": "hearing_scheduled", "date": "2026-11-02" }'

Response objects

The objects the attorney endpoints return. Response shapes are described by hand in the OpenAPI document and are deliberately loose.

AttorneyQueueItem

Name	Type	Required	Description
`id`	string	Yes	—
`mode`	string	Yes	One of: "test", "live".
`state`	string	Yes	—
`ground`	string	Yes	—
`entryPoint`	string	Yes	One of: "notice", "filing".
`jurisdiction`	object	Yes	—
`jurisdiction.state`	string	Yes	—
`jurisdiction.county`	string	No	—
`attention`	Attention	Yes	—
`createdAt`	string	Yes	Format: date-time.
`updatedAt`	string	Yes	Format: date-time.

Attention

Whether the case needs the attorney: it is on hold, or a job for it failed for good after its last state change.

Name	Type	Required	Description
`needed`	boolean	Yes	—
`reasons`	array of string	Yes	—

AttorneyCase

The case as its assigned attorney sees it. Each read is recorded in the audit log as `tenant_data_viewed`.

Name	Type	Required	Description
`id`	string	Yes	—
`mode`	string	Yes	One of: "test", "live".
`state`	string	Yes	Position in the case lifecycle, for example `notice_review` or `filing_submitted`.
`heldFrom`	string \| null	No	—
`ground`	string	Yes	—
`entryPoint`	string	Yes	One of: "notice", "filing".
`courtCaseNumber`	string \| null	No	—
`packVersions`	object \| null	No	—
`data`	object	Yes	—
`deadlines`	array of object	Yes	—
`deadlines[].name`	string	Yes	—
`deadlines[].date`	string	Yes	Format: date.
`deadlines[].citation`	string	Yes	—
`documents`	array of Document	Yes	—
`nextAction`	object	Yes	—
`nextAction.by`	string	Yes	One of: "customer", "attorney", "platform", "court", "none".
`nextAction.description`	string	Yes	—
`handling`	string	No	Who does the legal work. Every live case is `attorney_direct`: a licensed attorney engaged for the case reviews it, serves the notice and files in court, and the platform records each step. Every test case is `automated`: the sandbox pipeline. One of: "automated", "attorney_direct".
`attorney`	object \| null	No	The attorney engaged for an attorney-direct case, once recorded. Null until then, and always null for a test case.
`attorney.name`	string \| null	If attorney is sent	—
`attorney.firm`	string	If attorney is sent	—
`attorney.state`	string	If attorney is sent	The property's state.
`attorney.barNumber`	string \| null	If attorney is sent	The attorney's bar number in that state.
`erased`	boolean	No	Whether the details of the case were erased, which we do case by case on request. An erased case keeps its id, state, dates, deadline names and charges. In `data` the names and the address read `[erased]` (the state and county are kept) and every other fact is gone; `courtCaseNumber` is null; each document keeps its id and `contentHash`, its `filename` reads `[erased]` and downloading it answers 410 `erased`; messages read `[erased]`. Any request that would change the case answers 409 `erased`.
`erasedAt`	string \| null	No	When the details were erased. Null for a case that was not erased. Format: date-time.
`createdAt`	string	No	Format: date-time.
`updatedAt`	string	No	Format: date-time.
`gates`	GateResults	Yes	—
`evidence`	array of Document	Yes	—
`filings`	array of Filing	Yes	Every court filing, oldest first.
`serviceAttempts`	array of ServiceAttempt	Yes	Every service attempt, oldest first.
`attention`	Attention	Yes	—
`events`	array of Event	Yes	The full audit trail, including internal events.

Filing

A submission to the court. Attorney-only.

Name	Type	Required	Description
`id`	string	Yes	—
`status`	string	Yes	`submitted`, `accepted` or `rejected`.
`envelopeId`	string \| null	Yes	—
`courtCaseNumber`	string \| null	Yes	—
`rejectionReasons`	array \| null	Yes	The court's reasons, when it rejected the filing.
`createdAt`	string	Yes	Format: date-time.

ServiceAttempt

One request to serve a document on one defendant. Attorney-only.

Name	Type	Required	Description
`id`	string	Yes	—
`stage`	string	Yes	One of: "notice", "summons".
`method`	string	Yes	—
`status`	string	Yes	`pending`, `served` or `failed`.
`servedDate`	string \| null	Yes	Format: date.
`failureReason`	string \| null	Yes	The process server's reason, when service failed.
`createdAt`	string	Yes	Format: date-time.