ReachScore Docs
API Reference

Tests

Email deliverability tests. Create tests to send emails to our seed network and measure inbox placement, authentication, and spam scores.

Create a new email deliverability test. Returns a test object with a unique test_address. Send your email to this address to begin the test.

Headers

Idempotency-Keystring

Unique key for idempotent requests (max 255 characters)

Request Bodyrequired

fromstring<email>required

The sender email address for the test

subjectstring

Subject line of the test email (optional, for matching)

providersarray

Specific providers to test (default: all available)

gmailoutlookyahoo
test_modestring

Test speed/depth tradeoff

fastfull
metadataobject

Key-value pairs for your reference (max 20 keys)

Response

idstring

Unique test identifier (test_xxx)

objectstring

Always 'test'

from_addressstring<email>
test_addressstring<email>

Send your email here

statusstring
pendingawaiting_emailrunningcompletedfailedexpired
created_atstring<date-time>
livemodeboolean

Example Request

curl -X POST https://api.reachscore.co/v1/tests \
  -H "Authorization: Bearer rk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "marketing@yourcompany.com",
    "subject": "Spring Newsletter",
    "test_mode": "full"
  }'

Example Response

{
  "id": "test_7xK2mN9pQrT4v",
  "object": "test",
  "from_address": "marketing@yourcompany.com",
  "test_address": "test-7xk2mn9p@inbound.reachscore.co",
  "status": "awaiting_email",
  "created_at": "2026-03-11T10:30:00Z",
  "livemode": true
}
Previous: API OverviewNext: Domains