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": { /* Scoring results */ },
  "credits": {
    "creditsCharged": 5,
    "creditsRemaining": 995,
    "costPerPhone": 0.05,
    "phoneCount": 100
  },
  "error": null
}
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: Score contacts with comprehensive data and real-time credit tracking
  • Job Management: Retrieve and manage scoring jobs with enhanced pagination
  • Account: Monitor your credit balance and account information

​
Migration from v1

If you’re using v1 endpoints, we strongly recommend migrating to v2:
v1 Endpointv2 Endpoint
GET /api/jobsGET /api/public/v2/jobs
GET /api/jobs/{id}GET /api/public/v2/jobs/{jobId}
POST /api/contacts/scorePOST /api/public/v2/contacts/score
v1 endpoints are deprecated and will be discontinued in future releases. Please migrate to v2 for continued support and new features.