API Endpoints

Complete reference of all Owl Eyes API endpoints for managing verifications.

Base URL

Base URLtext
Loading...

For sandbox/testing, use:

Sandbox URLtext
Loading...

Verification Links

Create a Verification Link

Creates a new verification link that can be shared with users.

Endpointhttp
Loading...
Requestbash
Loading...
ParameterTypeRequiredDescription
flowTypestringYes"standard" or "enhanced"
referenceIdstringNoYour internal user/order ID
expiresInintegerNoSeconds until expiry (default: 86400)
redirectUrlstringNoURL to redirect after completion
metadataobjectNoCustom key-value pairs
Responsejson
Loading...

Get a Verification Link

Endpointhttp
Loading...
Requestbash
Loading...

List Verification Links

Endpointhttp
Loading...
Requestbash
Loading...
ParameterTypeDescription
limitintegerNumber of results (default: 10, max: 100)
startingAfterstringCursor for pagination
statusstringFilter by status
referenceIdstringFilter by reference ID

Delete a Verification Link

Endpointhttp
Loading...
Requestbash
Loading...

Verifications

Get a Verification

Retrieves details about a completed verification.

Endpointhttp
Loading...
Requestbash
Loading...
Responsejson
Loading...

List Verifications

Endpointhttp
Loading...
Requestbash
Loading...

Sessions

Create a Session

Creates a short-lived session token for SDK initialization.

Endpointhttp
Loading...
Requestbash
Loading...
Responsejson
Loading...
Use Case
Use sessions when you want to initialize the SDK on your server and pass a token to the client. This is more secure than using your publishable key directly.

Webhooks

Create a Webhook

Endpointhttp
Loading...
Requestbash
Loading...

List Webhooks

Endpointhttp
Loading...

Update a Webhook

Endpointhttp
Loading...

Delete a Webhook

Endpointhttp
Loading...

Analytics

Get Verification Analytics

Endpointhttp
Loading...
Requestbash
Loading...
Responsejson
Loading...

SDK Implementation Examples

Node.js SDK

node-sdk.jsjavascript
Loading...

Python SDK

python-sdk.pypython
Loading...