Skip to main content
To use the TitanX REST APIs, you need an API key. API keys are available for team subscriptions and higher tiers. Only the Team Admin on the company account can generate an API key. If you don’t have an API key or need assistance, please contact our sales team at sales@titanx.io.

​
Generating an API Key

To generate an API key, login to your TitanX Dashboard and navigate to the Account page and select the API Keys menu item.

​
Receiving Results

Scoring and enrichment are asynchronous. Submitting contacts returns a jobId; the processed contacts are delivered to your configured webhook endpoint. Set up a webhook to receive them — see the Webhooks guide. Check out our Scoring and Enrichment endpoints for more information.

​
Authentication

All API requests require authentication using a Bearer token. The token should contain the API key you generated from your TitanX Dashboard. Include this token in the Authorization header of your HTTP requests. 
curl -X POST https://app.titanx.io/api/public/v2/contacts/score \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      {
        "firstName": "Joey",
        "lastName": "Gilkey",
        "email": "example@email.com",
        "phone": "5558675309"
      }
    ]
  }'

​
Content Types

The TitanX API always accepts JSON in request bodies and returns JSON in response bodies. You will need to set the Content-Type header to application/json in your request.