Claim a case | Verifa

Claims a case for a reviewer. Succeeds if unclaimed, owned by the same user, or the previous claim has expired (30 minutes). Required scope: cases:write.

Authentication

X-API-Keystring

Organization API key. Keys are prefixed with vk_live_ (production) or vk_sandbox_ (sandbox).

Path parameters

case_idstringRequired

Request

This endpoint expects an object.

reviewer_idstringRequired

Org user public ID or UUID of the reviewer.

Response

Case claimed

idstring

Case public ID.

session_idstring

UUID of the associated session.

statusenum

created_atdatetime

decisionenum

Allowed values:

assigned_tostring or null

UUID of the assigned reviewer.

claimed_atdatetime or null

entered_review_atdatetime or null

decided_atdatetime or null

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

409

Conflict Error

$	curl -X POST https://devapi.withverifa.com/api/v1/cases/case_id/claim \
>	-H "X-API-Key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"reviewer_id": "usr_abc123"
>	}'

1	{
2	"id": "rvc_abc123",
3	"session_id": "string",
4	"status": "open",
5	"created_at": "2024-01-15T09:30:00Z",
6	"decision": "approved",
7	"assigned_to": "string",
8	"claimed_at": "2024-01-15T09:30:00Z",
9	"entered_review_at": "2024-01-15T09:30:00Z",
10	"decided_at": "2024-01-15T09:30:00Z"
11	}

$	curl -X POST https://devapi.withverifa.com/api/v1/cases/case_id/claim \
>	-H "X-API-Key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"reviewer_id": "usr_abc123"
>	}'

1	{
2	"id": "rvc_abc123",
3	"session_id": "string",
4	"status": "open",
5	"created_at": "2024-01-15T09:30:00Z",
6	"decision": "approved",
7	"assigned_to": "string",
8	"claimed_at": "2024-01-15T09:30:00Z",
9	"entered_review_at": "2024-01-15T09:30:00Z",
10	"decided_at": "2024-01-15T09:30:00Z"
11	}