Skip to main content
This guide walks through everything needed to make your first successful call to the Relaybase API.

1. Get an API key

If you haven’t already, create an account and generate an API key from the Relaybase dashboard. Copy it somewhere safe it’s only shown once.

2. Authenticate your request

Relaybase uses Bearer token authentication. Every request needs an Authorization header:
See Authentication for details.

3. Call the validation endpoint

Send a POST request to /v1/email/single-validate with the email you want to check:

4. Read the response

status tells you the overall classification (valid, invalid, or risky), and score gives you a 0–100 deliverability confidence signal. See Validation Results for what each field means.

Next steps

Validation Results

Understand the classification and scoring model.

Rate Limits

Avoid getting rate limited when validating many emails.