NAV Navbar
shell
  • Authentication
  • Account
  • Emails
  • Finder
  • Domain Search
  • Errors
  • Authentication

    curl "https://api.blazeverify/v1/{api_endpoint}?api_key=your_api_key"
    

    Make sure to replace your_api_key with your API key.

    Blaze Verify uses API keys to allow access to our API. To get started, sign up for an account here.

    Blaze Verify expects the API key to be included in all API requests to the server as a URL parameter.

    Your account will have two API keys. One will be your test key, denoted by a test_ prefix. A live key will have a live_ prefix. Test keys can be used to send requests to the /verify and /batch endpoints. The /batch_status endpoint is only accessible when using a live key.

    Account

    General Account Info

    curl "https://api.blazeverify.com/v1/account?api_key=your_api_key"
    
    

    The above command returns JSON structured like this:

    {
      "owner_email": "john@smith.com",
      "usage": {
        "emails_used": 5000,
        "emails_remaining": 0,
        "emails_additional": 29304
      }
    }
    

    Get general account information including usage.

    HTTP Request

    GET https://api.blazeverify.com/v1/account

    Parameters

    Parameter Required Description
    api_key true Your API key.

    Emails

    Verify

    curl "https://api.blazeverify.com/v1/verify?email=john@smith.com&api_key=your_api_key"
    
    

    The above command returns JSON structured like this:

    {
      "accept_all": null,
      "did_you_mean": null,
      "disposable": false,
      "domain": "smith.com",
      "email": "john@smith.com",
      "free": false,
      "reason": "accepted_email",
      "role": false,
      "score": 100,
      "state": "deliverable",
      "tag": null,
      "user": "john"
    }
    

    Verify a single email. If a verification request takes longer than the timeout, you may retry this request for up to 5 minutes. After 5 minutes, further requests will count against your usage. The verification result will be returned when it is available.

    HTTP Request

    GET https://api.blazeverify.com/v1/verify

    Parameters

    Parameter Required Description
    email true The email you want verified.
    smtp false The SMTP step takes up a majority of the API's response time. If you would like to speed up your response times, you can disable this step. Default: true
    accept_all false Does an accept-all check. Heavily impacts API's response time. Default: false
    timeout false Optional timeout to wait for response (in seconds). Min: 2, Max: 30. Default: 5
    api_key true Your API key.

    Finder

    Find an Email

    curl "https://api.blazeverify.com/v1/finder?api_key=your_api_key&name=john smith&domain=example.org"
    
    

    The above command returns JSON structured like this:

    {
        "email": "j.smith@example.org",
        "confidence": "high",
        "domain": "example.org",
        "name": "john smith",
        "sources": [
          {
            "url": "https://example.org/team",
            "found_on": "2018-11-01T16:36:55.390-04:00"
          }
        ],
        "role": false,
        "first_name": "John",
        "last_name": "Smith",
        "company": "Example Company"
    }
    

    Attempt to find an email given a person's name and domain.

    HTTP Request

    GET https://api.blazeverify.com/v1/finder

    Parameters

    Parameter Required Description
    api_key true Your API key.
    name true Name of the person who's email you are looking for.
    domain true Domain to search.

    Domain Search

    Find Emails for a domain

    curl "https://api.example.org/v1/domain_search?api_key=your_api_key&domain=example.org"
    
    

    The above command returns JSON structured like this:

    {
        "domain": "example.org",
        "professional": true,
        "total_emails": 10,
        "pattern": null,
        "name": null,
        "emails": [
            {
                "email": "perrin@example.org",
                "confidence": "low",
                "domain": "example.org",
                "sources": [
                  {
                    "url": "https://example.org",
                    "found_on": "2018-11-01T16:36:55.390-04:00"
                  }
                ],
                "role": false,
                "first_name": "Perrin",
                "last_name": "Aybara"
            },
            {
                "email": "balthamel@example.org",
                "confidence": "medium",
                "domain": "example.org",
                "sources": [
                  {
                    "url": "https://example.org",
                    "found_on": "2018-11-01T16:36:55.390-04:00"
                  }
                ],
                "role": false,
                "first_name": "Balthamel",
                "last_name": null
            },
            {
                "email": "birgitte@example.org",
                "confidence": "verified",
                "domain": "example.org",
                "sources": [
                  {
                    "url": "https://example.org",
                    "found_on": "2018-11-01T16:36:55.390-04:00"
                  }
                ],
                "role": false,
                "first_name": "Birgitte",
                "last_name": "Silverbow"
            },
            {
                "email": "asmodean@example.org",
                "confidence": "high",
                "domain": "example.org",
                "sources": [
                  {
                    "url": "https://example.org",
                    "found_on": "2018-11-01T16:36:55.390-04:00"
                  }
                ],
                "role": false,
                "first_name": "Asmodean",
                "last_name": null
            },
            {
                "email": "lanfear@example.org",
                "confidence": "medium",
                "domain": "example.org",
                "sources": [
                  {
                    "url": "https://example.org",
                    "found_on": "2018-11-01T16:36:55.390-04:00"
                  }
                ],
                "role": false,
                "first_name": "Lanfear",
                "last_name": null
            },
            {
                "email": "aginor@example.org",
                "confidence": "low",
                "domain": "example.org",
                "sources": [
                  {
                    "url": "https://example.org",
                    "found_on": "2018-11-01T16:36:55.390-04:00"
                  }
                ],
                "role": false,
                "first_name": "Aginor",
                "last_name": null
            },
            {
                "email": "aviendha@example.org",
                "confidence": "low",
                "domain": "example.org",
                "sources": [
                  {
                    "url": "https://example.org",
                    "found_on": "2018-11-01T16:36:55.390-04:00"
                  }
                ],
                "role": false,
                "first_name": "Aviendha",
                "last_name": null
            },
            {
                "email": "sammael@example.org",
                "confidence": "low",
                "domain": "example.org",
                "sources": [
                  {
                    "url": "https://example.org",
                    "found_on": "2018-11-01T16:36:55.390-04:00"
                  }
                ],
                "role": false,
                "first_name": "Sammael",
                "last_name": null
            },
            {
                "email": "nynaeve@example.org",
                "confidence": "high",
                "domain": "example.org",
                "sources": [
                  {
                    "url": "https://example.org",
                    "found_on": "2018-11-01T16:36:55.390-04:00"
                  }
                ],
                "role": false,
                "first_name": "Nynaeve",
                "last_name": "al'Meara"
            },
            {
                "email": "moiraine@example.org",
                "confidence": "low",
                "domain": "example.org",
                "sources": [
                  {
                    "url": "https://example.org",
                    "found_on": "2018-11-01T16:36:55.390-04:00"
                  }
                ],
                "role": false,
                "first_name": "Moiraine",
                "last_name": "Damodred"
            }
        ],
        "next_page": 2
    }
    

    Returns a paginated list of emails for a domain. You will be charged per page of results viewed. Once a page has been retrieved, you will not be charged again for that page for 30 days.

    HTTP Request

    GET https://api.blazeverify.com/v1/domain_search

    Parameters

    Parameter Required Description
    api_key true Your API key.
    domain true Domain to search.
    page false Page number to go to.

    Errors

    {
      "message": "API key is required"
    }
    

    The Blazeverify API uses the following error codes:

    Code Meaning
    400 Bad Request – Your request is structured incorrectly.
    401 Unauthorized – Your API key is wrong.
    429 Too Many Requests – You're requesting an endpoint too often.
    500 Internal Server Error – We had a problem with our server. Try again later.
    503 Service Unavailable – We're temporarily offline for maintenance. Please try again later.