secuveriAPI docs
OpenAPIMarkdown

Read your block and allow list entries

GET/v1/lists

Newest first. Contacts, devices and vendor_data are stored only as a keyed fingerprint, so an entry shows a masked hint, never the value. Needs the lists:read scope. At most 300 list calls per minute per organization.

Send your API key in the x-api-key header.

Query parameters

  • kindstring

    One ofblockallow

  • typestring

    One ofemailphoneipinstallationvendor_datacountry

  • limitinteger1–100default 50
  • offsetinteger≥ 0default 0

Responses

  • 200One page of entries.
    • entriesarray of ListEntry
      Show 8 child properties
      • idstringuuid
      • kindstring

        One ofblockallow

      • entry_typestring

        One ofemailphoneipinstallationvendor_datacountry

      • hintstring

        A masked hint for emails, phones, devices and vendor_data; the address or range for ip, the code for country.

      • reasonstring
      • source_verification_idstring | null

        Set when blocked from a verification.

      • created_atstringdate-time
      • expires_atstring | nulldate-time
    • totalinteger
    • limitinteger
    • offsetinteger
  • 400Invalid filter.
  • 401Missing, unknown or expired API key.
  • 403The key lacks the scope this call needs, or its IP allowlist refuses the caller.
  • 429More than 300 list calls in a minute.
curl https://api-verify.secuveri.com/v1/lists \
  -H "x-api-key: $SECUVERI_API_KEY"
Response · 200
{
  "entries": [
    {
      "id": "0b8f4f5e-3c2a-4d1b-9e7f-6a5c4b3d2e1f",
      "kind": "block",
      "entry_type": "email",
      "hint": "j***@example.com",
      "reason": "Confirmed fraud",
      "source_verification_id": "VRF-7KQ2M9XA",
      "created_at": "2026-10-23T09:12:44.120Z",
      "expires_at": "2026-10-23T09:12:44.120Z"
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}