Approve a case | Verifa

Approves a case. If the organization has dual review enabled, the first call submits a recommendation and the second call (by a different reviewer) finalizes the decision. 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 making the decision.

notesstring or nullOptional

Optional notes for the review decision.

rejection_reasonstring or nullOptional

Reason for rejection (only for reject action).

Response

Case approved or recommendation submitted.

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	import requests
2
3	url = "https://devapi.withverifa.com/api/v1/cases/case_id/approve"
4
5	payload = { "reviewer_id": "usr_abc123" }
6	headers = {
7	"X-API-Key": "<apiKey>",
8	"Content-Type": "application/json"
9	}
10
11	response = requests.post(url, json=payload, headers=headers)
12
13	print(response.json())

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	}