Skip to main content

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

NameTypeRequiredDescription
user_event_idintegerYesID of the user event to verify.
verification_service_idintegerYesID of the verification service performing the verification.
rider_location_resultintegerYesVerification result for the rider (0=Pass, 1=Fail, 2=Undetermined).
operator_location_resultintegerYesVerification 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
}
FieldTypeDescription
idintegerUnique identifier for the verification record
user_event_idintegerID of the user event that was verified
verification_service_idintegerID 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.