> ## Documentation Index
> Fetch the complete documentation index at: https://docs.titanx.io/llms.txt
> Use this file to discover all available pages before exploring further.

# TitanX API v2

> The current and recommended version of the TitanX API

# 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:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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:

```bash theme={null}
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