Creating a User Event Verification
Submit a verification result for a user event. This is used by verification services to report the outcome of verifying a user event.
- Each verification includes a result for both the rider and operator (ResultType).
- ResultType:
0
(PASS): User was verified to be at the required location or performed the required action.1
(FAIL): User was verified to NOT be at the required location or did NOT perform the required action.2
(UNDETERMINED): It was not possible to determine the user's presence or action with certainty.
Endpoint
POST /verification/user-event-verifications
Required Information
Name | Type | Required | Description |
---|---|---|---|
user_event_id | integer | Yes | ID of the user event to verify. |
verification_service_id | integer | Yes | ID of the verification service performing the verification. |
rider_location_result | integer | Yes | Verification result for the rider (0=Pass, 1=Fail, 2=Undetermined). |
operator_location_result | integer | Yes | Verification result for the operator (0=Pass, 1=Fail, 2=Undetermined). |
Example Request
curl -X POST "https://api.opteverything.com/verification/user-event-verifications" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <YOUR_TOKEN>" \
-d '{
"user_event_id": 42,
"verification_service_id": 1,
"rider_location_result": 0,
"operator_location_result": 0
}'
Responses
Success (201 Created)
Status Code: 201 Created
{
"id": 100,
"user_event_id": 42,
"verification_service_id": 1
}
Field | Type | Description |
---|---|---|
id | integer | Unique identifier for the verification record |
user_event_id | integer | ID of the user event that was verified |
verification_service_id | integer | ID of the verification service that performed the verification |
Error Responses
- 400 Bad Request: Invalid user event ID, invalid verification service ID, or other validation errors.
- 401 Unauthorized: If not authenticated.