Skip to main content
POST
/
api
/
public
/
v2
/
contacts
/
score
Score contacts
curl --request POST \
  --url https://app.titanx.io/api/public/v2/contacts/score \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "contacts": [
    {
      "firstName": "<string>",
      "lastName": "<string>",
      "email": "jsmith@example.com",
      "phone": "<string>",
      "phone2": "<string>",
      "phone3": "<string>",
      "phone4": "<string>",
      "phone5": "<string>",
      "phoneExt": "<string>",
      "phoneStatus": "<string>",
      "phone2Status": "<string>",
      "phone3Status": "<string>",
      "phone4Status": "<string>",
      "phone5Status": "<string>",
      "phoneType": "<string>",
      "phone2Type": "<string>",
      "phone3Type": "<string>",
      "phone4Type": "<string>",
      "phone5Type": "<string>",
      "street": "<string>",
      "city": "<string>",
      "stateProvince": "<string>",
      "zipPostalCode": "<string>",
      "country": "<string>",
      "title": "<string>",
      "companyAccount": "<string>",
      "website": "<string>",
      "linkedInUrl": "<string>",
      "companyLinkedInUrl": "<string>",
      "persona": "<string>",
      "dept": "<string>",
      "level": "<string>",
      "jobFunction": "<string>",
      "timeZone": "<string>",
      "companyCountry": "<string>",
      "companyState": "<string>",
      "companyCity": "<string>",
      "companyZip": "<string>",
      "companyAddress": "<string>",
      "numberOfEmployees": "<string>",
      "annualRevenue": "<string>",
      "industry": "<string>",
      "primarySubIndustry": "<string>",
      "sicCodes": "<string>",
      "naicsCodes": "<string>",
      "technologies": "<string>",
      "recordOwner": "<string>",
      "contactCrmId": "<string>",
      "accountCrmId": "<string>",
      "databaseContactId": "<string>",
      "databaseCompanyId": "<string>",
      "customerContactId": "<string>",
      "campaignListName": "<string>",
      "callbackUrl": "<string>",
      "leadId": "<string>",
      "fsTotalCalls": "<string>",
      "unmappedFields": {}
    }
  ],
  "scoringType": "lightning"
}'
{
  "data": {
    "totalRecordCount": 1,
    "acceptedRecordCount": 1,
    "jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  },
  "credits": {
    "creditsCharged": 1,
    "creditsRemaining": 1,
    "costPerPhone": 1,
    "phoneCount": 1
  },
  "error": {
    "rejectedRecordCount": 1,
    "records": [
      "<any>"
    ]
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
contacts
object[]
required
Maximum length: 1000
scoringType
enum<string>
default:lightning
Available options:
lightning,
titan

Response

200 - application/json

Successful response with contact scores and credit information

data
object
required
credits
object
error
object