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). Requires cases:write scope.

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

1	using RestSharp;
2
3	var client = new RestClient("https://devapi.withverifa.com/api/v1/cases/case_id/claim");
4	var request = new RestRequest(Method.POST);
5	request.AddHeader("X-API-Key", "<apiKey>");
6	request.AddHeader("Content-Type", "application/json");
7	request.AddParameter("application/json", "{\n \"reviewer_id\": \"usr_abc123\"\n}", ParameterType.RequestBody);
8	IRestResponse response = client.Execute(request);

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	}