List Verification Tracking Events

curl --request GET \
  --url https://api.dataspike.io/api/v4/verifications/{verification_id}/events \
  --header 'ds-api-token: <api-key>'

{
  "data": [
    {
      "verification_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organization_id": "o6e501dc4d3c6d9a4",
      "event": "upload_file",
      "reference_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "country": {
        "name": "United States of America",
        "alpha2": "US",
        "alpha3": "USA"
      },
      "user_agent": {
        "header": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.3.1 Safari/605.1.15",
        "device_type": "desktop",
        "device_os": "macOS 10.15.7",
        "browser": "Safari v18.3.1"
      },
      "ip_address": "10.2.13.249",
      "http_status": 400,
      "verification_errors": [
        5014
      ],
      "api_version": "e3b9b5e",
      "created_at": "2025-04-07T16:37:47.722Z"
    }
  ],
  "has_next": false
}

GET

api

verifications

{verification_id}

events

List Verification Tracking Events

curl --request GET \
  --url https://api.dataspike.io/api/v4/verifications/{verification_id}/events \
  --header 'ds-api-token: <api-key>'

{
  "data": [
    {
      "verification_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "organization_id": "o6e501dc4d3c6d9a4",
      "event": "upload_file",
      "reference_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "country": {
        "name": "United States of America",
        "alpha2": "US",
        "alpha3": "USA"
      },
      "user_agent": {
        "header": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.3.1 Safari/605.1.15",
        "device_type": "desktop",
        "device_os": "macOS 10.15.7",
        "browser": "Safari v18.3.1"
      },
      "ip_address": "10.2.13.249",
      "http_status": 400,
      "verification_errors": [
        5014
      ],
      "api_version": "e3b9b5e",
      "created_at": "2025-04-07T16:37:47.722Z"
    }
  ],
  "has_next": false
}

Authorizations

ds-api-token

string

header

required

Path Parameters

verification_id

string<uuid>

required

Verification Identifier

Response

data

object[]

required

List of an existing paginated items List of verification tracking events

Show child attributes

data.verification_id

string<uuid>

Verification identifier

data.organization_id

string

Organization identifier

Example:

"o6e501dc4d3c6d9a4"

data.event

enum<string>

Event type

Available options:

open,

upload_file,

submit,

set_country,

set_custom_fields,

upload_custom_file

Example:

"upload_file"

data.reference_id

string<uuid> | null

Reference object identifier

data.country

object

Show child attributes

data.country.name

string

Country full official name

Example:

"United States of America"

data.country.alpha2

string

ISO 3166-1 alpha-2 country code

Required string length: 2

Example:

"US"

data.country.alpha3

string

ISO 3166-1 alpha-3 country code

Required string length: 3

Example:

"USA"

data.user_agent

object

Show child attributes

data.user_agent.header

string

User agent header string

Example:

"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/18.3.1 Safari/605.1.15"

data.user_agent.device_type

enum<string>

Device type

Available options:

bot,

desktop,

mobile,

tablet,

unknown

Example:

"desktop"

data.user_agent.device_os

string

Device operating system

Example:

"macOS 10.15.7"

data.user_agent.browser

string

Browser name and version

Example:

"Safari v18.3.1"

data.ip_address

string | null

Client IP address

Example:

"10.2.13.249"

data.http_status

integer | null

HTTP status code

Example:

400

data.verification_errors

integer[]

Array of verification errors

data.api_version

string | null

API version

Example:

"e3b9b5e"

data.created_at

string<date-time>

Example:

"2025-04-07T16:37:47.722Z"

has_next

boolean

default:false

This property serves as an indicator of whether there is a next page available in the paginated result

Cancel existing Verification Get Verification PDF Report

⌘I

API documentation

Authorizations

Path Parameters

Response