Create a review case | Verifa

Creates a review case for an existing session. If a case already exists for the session, returns the existing case. Required scope: cases:write.

Authentication

X-API-Keystring

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

Request

This endpoint expects an object.

session_idstringRequired<=64 characters

Session public ID or UUID.

Response

Case created or existing case returned

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

401

Unauthorized Error

404

Not Found Error

$	curl -X POST https://devapi.withverifa.com/api/v1/cases \
>	-H "X-API-Key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"session_id": "ses_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 \
>	-H "X-API-Key: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"session_id": "ses_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	}