Skip to main content

​
TitanX API v2 ✅

Welcome to TitanX API v2 - our current and actively maintained API. This version provides enhanced functionality, improved error handling, and consistent responses with credit tracking.

​
Base URL

https://app.titanx.io/api/public/v2

​
Key Features

​
💳 Contact Scoring with Credit Tracking

Our contact scoring endpoints provide enhanced responses with real-time credit usage information: 
{
  "data": { "jobId": "…", "totalRecordCount": 100, "acceptedRecordCount": 95 },
  "credits": {
    "creditsCharged": 5,
    "creditsRemaining": 995,
    "costPerPhone": 0.05,
    "phoneCount": 100
  },
  "error": null
}
Scoring runs asynchronously — data is a job acknowledgement; the scored contacts arrive later via the job.contact.scored webhook. Credit tracking features:
  • Real-time credit usage reporting
  • Remaining balance visibility
  • Cost transparency per contact
  • Phone count tracking

​
🚀 Consistent Response Format

All v2 endpoints return data wrapped in a consistent structure: 
{
  "data": { /* Your requested data */ }
}

​
🛡️ Improved Error Handling

  • Better error response format
  • Detailed error messages
  • HTTP status codes aligned with REST standards

​
📊 Enhanced Performance

  • Optimized endpoints for faster response times
  • Support for larger batch operations (up to 1000 contacts)
  • Better pagination support

​
Authentication

All endpoints require Bearer token authentication: 
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://app.titanx.io/api/public/v2/jobs

​
Available Endpoints

  • Contact Data: Submit contacts for asynchronous scoring or enrichment; results arrive via the job.contact.scored webhook. Responses include real-time credit tracking.
  • Job Management: Retrieve and manage scoring jobs with enhanced pagination
  • Account: Monitor your credit balance and account information