keys

Get a personal test key

Issues a personal test key (mv_test_…) for a work e-mail address, protected by a Cloudflare Turnstile token from the form at https://mobilevalidate.com/get-test-key. The key works in test mode with any number (never billed, never reaches a data source), including bulk jobs and test-mode webhooks. It is shown once and never returned again. Each address can receive at most 3 test keys in 30 days; after that the answer is 409 test_key_exists. At most 3 requests per network per day, whatever their result (IPv6 networks count per /64). The request also asks for live access, which we review by hand. No authentication.

post/test-keys

Request

  • Base URL: https://api.mobilevalidate.com/v1
  • URL: https://api.mobilevalidate.com/v1/test-keys
  • Auth: none required

Request body

emailstring email required

Work e-mail address (must receive mail).

namestring
companystring required

Company name.

countrystring required

ISO 3166-1 alpha-2 country of the company.

accept_termstrue required

The company accepts the Terms of Service, the Acceptable Use Policy and the Data Processing Agreement (https://mobilevalidate.com/legal/terms, /legal/acceptable-use, /legal/dpa) and is responsible for the lawful use of the service and its results. Recorded with the document versions.

use_casestring
turnstile_tokenstring required

Token from the Turnstile widget on mobilevalidate.com.

session_idstring

Optional. Set by the form on mobilevalidate.com to link the key to the page visit that led to it (first-party, per browser tab, no cookie; not sent when the browser signals Do-Not-Track or Global Privacy Control). Unknown or malformed values are ignored.

Response

The key (shown only once).

keystring required
key_prefixstring required

First characters of the key, for display.

docs_urlstring uri required
request_idstring required

Changes

No recorded changes to this operation across all 1 revision of this API.