Identity

List Resolutions

post

Returns a paginated list of identified visitors for the given date range. Each record is one unique person, enriched with contact and company data. Defaults to the last 7 days if no dates are provided.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

sizeinteger · min: 1 · max: 100Optional

Page size

Default: 10

Body

start_datestring · nullableOptional

Start of the date range (YYYY-MM-DD). Defaults to 7 days ago.

end_datestring · nullableOptional

End of the date range (YYYY-MM-DD). Defaults to today.

Responses

200

Successful Response

application/json

Paginated resolutions list returned by the Identity API.

pageintegerRequired

sizeintegerRequired

totalintegerRequired

pagesintegerRequired

422

Validation Error

application/json

post/identity/resolutions

POST /identity/resolutions HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 470

{
  "start_date": "text",
  "end_date": "text",
  "filters": {
    "visitors": [
      {
        "field": "text",
        "method": "equals",
        "value": null
      }
    ],
    "sessions": [
      {
        "field": "text",
        "method": "equals",
        "value": null
      }
    ],
    "pages": [
      {
        "field": "text",
        "method": "equals",
        "value": null
      }
    ],
    "buyer_intent": [
      {
        "field": "text",
        "method": "equals",
        "value": null
      }
    ],
    "enrichment": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "field": "text",
          "method": "equals",
          "value": null
        }
      ]
    },
    "ml": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "field": "text",
          "method": "equals",
          "value": null
        }
      ]
    }
  }
}

{
  "items": [
    {
      "hem": "text",
      "email": "text",
      "personal_email": "text",
      "business_email": "text",
      "first_name": "text",
      "last_name": "text",
      "gender": "text",
      "age_range": "text",
      "married": "text",
      "income_range": "text",
      "net_worth": "text",
      "homeowner": "text",
      "personal_address": "text",
      "personal_address2": "text",
      "personal_city": "text",
      "personal_state": "text",
      "personal_zip": "text",
      "personal_zip4": "text",
      "personal_phone": "text",
      "mobile_phone": "text",
      "job_title": "text",
      "seniority_level": "text",
      "department": "text",
      "professional_address": "text",
      "professional_address2": "text",
      "professional_city": "text",
      "professional_state": "text",
      "professional_zip": "text",
      "professional_zip4": "text",
      "linkedin_url": "text",
      "company_name": "text",
      "company_domain": "text",
      "company_phone": "text",
      "company_sic": "text",
      "company_naics": "text",
      "company_address": "text",
      "company_city": "text",
      "company_state": "text",
      "company_zip": "text",
      "company_linkedin_url": "text",
      "company_revenue": "text",
      "company_employee_count": "text",
      "primary_industry": "text",
      "ip": "text",
      "tag_id": "text",
      "file_type": "text",
      "last_session_date": "2026-01-01T00:00:00.000Z",
      "last_session_total_pages_visited": 1,
      "total_session_count": 1,
      "last_session_entry_url": "text",
      "last_session_entry_referer_url": "text",
      "last_session_exit_url": "text",
      "last_session_est_duration": 1,
      "lead_category": "text",
      "business_email_validation_status": "text",
      "business_email_last_seen": 1,
      "personal_email_validation_status": "text",
      "personal_email_last_seen": 1
    }
  ],
  "page": 1,
  "size": 1,
  "total": 1,
  "pages": 1
}

Count Resolutions

post

Returns visitor counts grouped by record type (b2b, b2c, pte) for the given date range — useful for dashboards and usage tracking.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Body

start_datestring · nullableOptional

Start of the date range (YYYY-MM-DD). Defaults to 7 days ago.

end_datestring · nullableOptional

End of the date range (YYYY-MM-DD). Defaults to today.

Responses

200

Successful Response

application/json

Count of resolutions for the given date range and filters.

b2bintegerOptionalDefault: 0

b2cintegerOptionalDefault: 0

pteintegerOptionalDefault: 0

totalintegerRead-onlyRequired

Other propertiesanyOptional

422

Validation Error

application/json

post/identity/resolutions/count

POST /identity/resolutions/count HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 470

{
  "start_date": "text",
  "end_date": "text",
  "filters": {
    "visitors": [
      {
        "field": "text",
        "method": "equals",
        "value": null
      }
    ],
    "sessions": [
      {
        "field": "text",
        "method": "equals",
        "value": null
      }
    ],
    "pages": [
      {
        "field": "text",
        "method": "equals",
        "value": null
      }
    ],
    "buyer_intent": [
      {
        "field": "text",
        "method": "equals",
        "value": null
      }
    ],
    "enrichment": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "field": "text",
          "method": "equals",
          "value": null
        }
      ]
    },
    "ml": {
      "ANY_ADDITIONAL_PROPERTY": [
        {
          "field": "text",
          "method": "equals",
          "value": null
        }
      ]
    }
  }
}

{
  "b2b": 0,
  "b2c": 0,
  "pte": 0,
  "total": 1,
  "ANY_ADDITIONAL_PROPERTY": "anything"
}

Get Billing Breakdown

post

Returns daily unique visitor counts broken down by tag and record type. Useful for building usage and billing charts.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Body

start_datestring · nullableOptional

Start of the date range (YYYY-MM-DD). Defaults to 7 days ago.

end_datestring · nullableOptional

End of the date range (YYYY-MM-DD). Defaults to today.

Responses

200

Successful Response

application/json

Billing count of resolutions by day, tag_id, and file_type for the given date range.

event_datestring · dateRequired

tag_idstringRequired

file_typestringRequired

visitor_countintegerRequired

Other propertiesanyOptional

422

Validation Error

application/json

post/identity/resolutions/billing

POST /identity/resolutions/billing HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 39

{
  "start_date": "text",
  "end_date": "text"
}

[
  {
    "event_date": "2026-01-01",
    "tag_id": "text",
    "file_type": "text",
    "visitor_count": 1,
    "ANY_ADDITIONAL_PROPERTY": "anything"
  }
]

List Visitors

post

Returns a paginated list of visitor profiles, optionally filtered by date range and visitor attributes.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

sizeinteger · min: 1 · max: 100Optional

Page size

Default: 50

sortstring · enumOptional

Sort order

Default: descPossible values:

Body

start_datestring · nullableOptional

Start of the date range (YYYY-MM-DD). Defaults to 7 days ago.

end_datestring · nullableOptional

End of the date range (YYYY-MM-DD). Defaults to today.

Responses

200

Successful Response

application/json

totalintegerRequired

pageinteger · min: 1Required

sizeinteger · min: 1Required

pagesintegerRequired

422

Validation Error

application/json

post/identity/visitors

POST /identity/visitors HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "start_date": "text",
  "end_date": "text",
  "filters": [
    {
      "field": "text",
      "method": "equals",
      "value": null
    }
  ]
}

{
  "items": [
    {
      "hem": "text",
      "email": "text",
      "record_uuid": "text",
      "first_name": "text",
      "last_name": "text",
      "business_email": "text",
      "mobile_phone": "text",
      "linkedin_url": "text",
      "personal_address": "text",
      "personal_address2": "text",
      "personal_city": "text",
      "personal_state": "text",
      "personal_zip": "text",
      "personal_zip4": "text",
      "personal_email": "text",
      "personal_phone": "text",
      "gender": "text",
      "age_range": "text",
      "married": "text",
      "income_range": "text",
      "net_worth": "text",
      "homeowner": "text",
      "job_title": "text",
      "seniority_level": "text",
      "department": "text",
      "professional_address": "text",
      "professional_address2": "text",
      "professional_city": "text",
      "professional_state": "text",
      "professional_zip": "text",
      "professional_zip4": "text",
      "company_name": "text",
      "company_domain": "text",
      "company_phone": "text",
      "company_sic": "text",
      "company_naics": "text",
      "company_address": "text",
      "company_city": "text",
      "company_state": "text",
      "company_zip": "text",
      "company_linkedin_url": "text",
      "company_revenue": "text",
      "company_employee_count": "text",
      "primary_industry": "text",
      "business_email_validation_status": "text",
      "business_email_last_seen": 1,
      "personal_email_validation_status": "text",
      "personal_email_last_seen": 1,
      "ip": "text",
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 1,
  "pages": 1
}

Get Visitor

get

Returns the full enriched profile for a single visitor — contact info, company details, demographics, and more. Returns 404 if the visitor is not found.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Path parameters

emailstringRequired

Responses

200

Successful Response

application/json

Visitor profile returned by the Identity API.

hemstringRequired

emailstring · nullableOptional

record_uuidstring · nullableOptional

first_namestring · nullableOptional

last_namestring · nullableOptional

business_emailstring · nullableOptional

mobile_phonestring · nullableOptional

linkedin_urlstring · nullableOptional

personal_addressstring · nullableOptional

personal_address2string · nullableOptional

personal_citystring · nullableOptional

personal_statestring · nullableOptional

personal_zipstring · nullableOptional

personal_zip4string · nullableOptional

personal_emailstring · nullableOptional

personal_phonestring · nullableOptional

genderstring · nullableOptional

age_rangestring · nullableOptional

marriedstring · nullableOptional

income_rangestring · nullableOptional

net_worthstring · nullableOptional

homeownerstring · nullableOptional

job_titlestring · nullableOptional

seniority_levelstring · nullableOptional

departmentstring · nullableOptional

professional_addressstring · nullableOptional

professional_address2string · nullableOptional

professional_citystring · nullableOptional

professional_statestring · nullableOptional

professional_zipstring · nullableOptional

professional_zip4string · nullableOptional

company_namestring · nullableOptional

company_domainstring · nullableOptional

company_phonestring · nullableOptional

company_sicstring · nullableOptional

company_naicsstring · nullableOptional

company_addressstring · nullableOptional

company_citystring · nullableOptional

company_statestring · nullableOptional

company_zipstring · nullableOptional

company_linkedin_urlstring · nullableOptional

company_revenuestring · nullableOptional

company_employee_countstring · nullableOptional

primary_industrystring · nullableOptional

business_email_validation_statusstring · nullableOptional

business_email_last_seeninteger · nullableOptional

personal_email_validation_statusstring · nullableOptional

personal_email_last_seeninteger · nullableOptional

ipstring · nullableOptional

updated_atstring · date-time · nullableRead-onlyRequired

422

Validation Error

application/json

get/identity/visitors/{email}

GET /identity/visitors/{email} HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "hem": "text",
  "email": "text",
  "record_uuid": "text",
  "first_name": "text",
  "last_name": "text",
  "business_email": "text",
  "mobile_phone": "text",
  "linkedin_url": "text",
  "personal_address": "text",
  "personal_address2": "text",
  "personal_city": "text",
  "personal_state": "text",
  "personal_zip": "text",
  "personal_zip4": "text",
  "personal_email": "text",
  "personal_phone": "text",
  "gender": "text",
  "age_range": "text",
  "married": "text",
  "income_range": "text",
  "net_worth": "text",
  "homeowner": "text",
  "job_title": "text",
  "seniority_level": "text",
  "department": "text",
  "professional_address": "text",
  "professional_address2": "text",
  "professional_city": "text",
  "professional_state": "text",
  "professional_zip": "text",
  "professional_zip4": "text",
  "company_name": "text",
  "company_domain": "text",
  "company_phone": "text",
  "company_sic": "text",
  "company_naics": "text",
  "company_address": "text",
  "company_city": "text",
  "company_state": "text",
  "company_zip": "text",
  "company_linkedin_url": "text",
  "company_revenue": "text",
  "company_employee_count": "text",
  "primary_industry": "text",
  "business_email_validation_status": "text",
  "business_email_last_seen": 1,
  "personal_email_validation_status": "text",
  "personal_email_last_seen": 1,
  "ip": "text",
  "updated_at": "2026-01-01T00:00:00.000Z"
}

Get Visitor Profile

get

Returns the visitor's profile together with their most recent sessions and the pages viewed in each. Use session_limit to control how many sessions are included (max 10).

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Path parameters

emailstringRequired

Query parameters

session_limitinteger · min: 1 · max: 10Optional

Number of recent sessions to include. Max 10.

Default: 5

Responses

200

Successful Response

application/json

Full visitor profile with recent sessions and their page views.

422

Validation Error

application/json

get/identity/visitors/{email}/profile

GET /identity/visitors/{email}/profile HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "visitor": {
    "hem": "text",
    "email": "text",
    "record_uuid": "text",
    "first_name": "text",
    "last_name": "text",
    "business_email": "text",
    "mobile_phone": "text",
    "linkedin_url": "text",
    "personal_address": "text",
    "personal_address2": "text",
    "personal_city": "text",
    "personal_state": "text",
    "personal_zip": "text",
    "personal_zip4": "text",
    "personal_email": "text",
    "personal_phone": "text",
    "gender": "text",
    "age_range": "text",
    "married": "text",
    "income_range": "text",
    "net_worth": "text",
    "homeowner": "text",
    "job_title": "text",
    "seniority_level": "text",
    "department": "text",
    "professional_address": "text",
    "professional_address2": "text",
    "professional_city": "text",
    "professional_state": "text",
    "professional_zip": "text",
    "professional_zip4": "text",
    "company_name": "text",
    "company_domain": "text",
    "company_phone": "text",
    "company_sic": "text",
    "company_naics": "text",
    "company_address": "text",
    "company_city": "text",
    "company_state": "text",
    "company_zip": "text",
    "company_linkedin_url": "text",
    "company_revenue": "text",
    "company_employee_count": "text",
    "primary_industry": "text",
    "business_email_validation_status": "text",
    "business_email_last_seen": 1,
    "personal_email_validation_status": "text",
    "personal_email_last_seen": 1,
    "ip": "text",
    "updated_at": "2026-01-01T00:00:00.000Z"
  },
  "sessions": [
    {
      "id": "text",
      "hem": "text",
      "tag_id": "text",
      "file_type": "text",
      "session_start": "2026-01-01T00:00:00.000Z",
      "session_end": "2026-01-01T00:00:00.000Z",
      "est_session_duration": 1,
      "entry_url": "text",
      "entry_referer_url": "text",
      "exit_url": "text",
      "total_pages_visited": 1,
      "unique_pages_visited": 1,
      "pages": [
        {
          "id": "text",
          "hem": "text",
          "session_id": "text",
          "external_id": "text",
          "tag_id": "text",
          "file_type": "text",
          "ref_url": "text",
          "referer_url": "text",
          "est_time_on_page": 1,
          "event_date": "2026-01-01T00:00:00.000Z",
          "updated_at": "2026-01-01T00:00:00.000Z"
        }
      ],
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Get Visitor Sessions

get

Returns the visitor's site sessions, most recent first.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Path parameters

emailstringRequired

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

sizeinteger · min: 1 · max: 100Optional

Page size

Default: 50

Responses

200

Successful Response

application/json

totalintegerRequired

pageinteger · min: 1Required

sizeinteger · min: 1Required

pagesintegerRequired

422

Validation Error

application/json

get/identity/visitors/{email}/sessions

GET /identity/visitors/{email}/sessions HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "text",
      "hem": "text",
      "tag_id": "text",
      "file_type": "text",
      "session_start": "2026-01-01T00:00:00.000Z",
      "session_end": "2026-01-01T00:00:00.000Z",
      "est_session_duration": 1,
      "entry_url": "text",
      "entry_referer_url": "text",
      "exit_url": "text",
      "total_pages_visited": 1,
      "unique_pages_visited": 1,
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 1,
  "pages": 1
}

Get Session Page Views

get

Returns the pages the visitor viewed during a specific session, in the order they were visited.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Path parameters

emailstringRequired

session_idstringRequired

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

sizeinteger · min: 1 · max: 100Optional

Page size

Default: 50

Responses

200

Successful Response

application/json

totalintegerRequired

pageinteger · min: 1Required

sizeinteger · min: 1Required

pagesintegerRequired

422

Validation Error

application/json

get/identity/visitors/{email}/sessions/{session_id}/pages

GET /identity/visitors/{email}/sessions/{session_id}/pages HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "text",
      "hem": "text",
      "session_id": "text",
      "external_id": "text",
      "tag_id": "text",
      "file_type": "text",
      "ref_url": "text",
      "referer_url": "text",
      "est_time_on_page": 1,
      "event_date": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 1,
  "pages": 1
}

Get Visitor Page Views

get

Returns all pages the visitor has viewed across every session, most recent first.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Path parameters

emailstringRequired

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

sizeinteger · min: 1 · max: 100Optional

Page size

Default: 50

Responses

200

Successful Response

application/json

totalintegerRequired

pageinteger · min: 1Required

sizeinteger · min: 1Required

pagesintegerRequired

422

Validation Error

application/json

get/identity/visitors/{email}/pages

GET /identity/visitors/{email}/pages HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "text",
      "hem": "text",
      "session_id": "text",
      "external_id": "text",
      "tag_id": "text",
      "file_type": "text",
      "ref_url": "text",
      "referer_url": "text",
      "est_time_on_page": 1,
      "event_date": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 1,
  "pages": 1
}

Get Visitor Buyer Intent

get

Returns the buyer intent score (hot, warm, or cold) for the visitor.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Path parameters

emailstringRequired

Responses

200

Successful Response

application/json

idstringRequired

hemstringRequired

tag_idstringRequired

lead_categorystringRequired

422

Validation Error

application/json

get/identity/visitors/{email}/buyer-intent

GET /identity/visitors/{email}/buyer-intent HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "id": "text",
    "hem": "text",
    "tag_id": "text",
    "lead_category": "text"
  }
]

Get Visitor ICP Score

get

Returns the visitor's ICP prediction score and their percentile rank against your ideal customer profile. Returns 404 if no score exists for this visitor.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Path parameters

emailstringRequired

Responses

200

Successful Response

application/json

idstringRequired

hemstringRequired

tag_idstringRequired

emailstringRequired

predictionnumber · nullableOptional

percentilenumber · nullableOptional

422

Validation Error

application/json

get/identity/visitors/{email}/icp

GET /identity/visitors/{email}/icp HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": "text",
  "hem": "text",
  "tag_id": "text",
  "email": "text",
  "prediction": 1,
  "percentile": 1
}

List Sessions

post

Returns a paginated list of site sessions across all visitors for the given date range.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

sizeinteger · min: 1 · max: 100Optional

Page size

Default: 50

sortstring · enumOptional

Sort by session_end

Default: descPossible values:

Body

start_datestring · nullableOptional

Start of the date range (YYYY-MM-DD). Defaults to 7 days ago.

end_datestring · nullableOptional

End of the date range (YYYY-MM-DD). Defaults to today.

Responses

200

Successful Response

application/json

totalintegerRequired

pageinteger · min: 1Required

sizeinteger · min: 1Required

pagesintegerRequired

422

Validation Error

application/json

post/identity/sessions

POST /identity/sessions HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "start_date": "text",
  "end_date": "text",
  "filters": [
    {
      "field": "text",
      "method": "equals",
      "value": null
    }
  ]
}

{
  "items": [
    {
      "id": "text",
      "hem": "text",
      "tag_id": "text",
      "file_type": "text",
      "session_start": "2026-01-01T00:00:00.000Z",
      "session_end": "2026-01-01T00:00:00.000Z",
      "est_session_duration": 1,
      "entry_url": "text",
      "entry_referer_url": "text",
      "exit_url": "text",
      "total_pages_visited": 1,
      "unique_pages_visited": 1,
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 1,
  "pages": 1
}

Get Session Page Views

get

Returns the pages viewed in a specific session, in chronological order.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Path parameters

session_idstringRequired

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

sizeinteger · min: 1 · max: 100Optional

Page size

Default: 50

Responses

200

Successful Response

application/json

totalintegerRequired

pageinteger · min: 1Required

sizeinteger · min: 1Required

pagesintegerRequired

422

Validation Error

application/json

get/identity/sessions/{session_id}/pages

GET /identity/sessions/{session_id}/pages HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "text",
      "hem": "text",
      "session_id": "text",
      "external_id": "text",
      "tag_id": "text",
      "file_type": "text",
      "ref_url": "text",
      "referer_url": "text",
      "est_time_on_page": 1,
      "event_date": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 1,
  "pages": 1
}

List Page Views

post

Returns a paginated list of page views across all visitors for the given date range.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

sizeinteger · min: 1 · max: 100Optional

Page size

Default: 50

sortstring · enumOptional

Sort by event_date

Default: descPossible values:

Body

start_datestring · nullableOptional

Start of the date range (YYYY-MM-DD). Defaults to 7 days ago.

end_datestring · nullableOptional

End of the date range (YYYY-MM-DD). Defaults to today.

Responses

200

Successful Response

application/json

totalintegerRequired

pageinteger · min: 1Required

sizeinteger · min: 1Required

pagesintegerRequired

422

Validation Error

application/json

post/identity/pages

POST /identity/pages HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 99

{
  "start_date": "text",
  "end_date": "text",
  "filters": [
    {
      "field": "text",
      "method": "equals",
      "value": null
    }
  ]
}

{
  "items": [
    {
      "id": "text",
      "hem": "text",
      "session_id": "text",
      "external_id": "text",
      "tag_id": "text",
      "file_type": "text",
      "ref_url": "text",
      "referer_url": "text",
      "est_time_on_page": 1,
      "event_date": "2026-01-01T00:00:00.000Z",
      "updated_at": "2026-01-01T00:00:00.000Z"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 1,
  "pages": 1
}

List Buyer Intent

post

Returns buyer intent records (lead categories) across your workspace.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

sizeinteger · min: 1 · max: 100Optional

Page size

Default: 50

Responses

200

Successful Response

application/json

totalintegerRequired

pageinteger · min: 1Required

sizeinteger · min: 1Required

pagesintegerRequired

422

Validation Error

application/json

post/identity/buyer-intent

POST /identity/buyer-intent HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "text",
      "hem": "text",
      "tag_id": "text",
      "lead_category": "text"
    }
  ],
  "total": 1,
  "page": 1,
  "size": 1,
  "pages": 1
}

List ICP Scores

post

Returns ICP scores for all visitors, sorted by percentile.

Authorizations

AuthorizationstringRequired

Bearer token for authentication

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

sizeinteger · min: 1 · max: 100Optional

Page size

Default: 50

sortstring · enumOptional

Sort by percentile

Default: descPossible values:

Responses

200

Successful Response

application/json

totalintegerRequired

pageinteger · min: 1Required

sizeinteger · min: 1Required

pagesintegerRequired

422

Validation Error

application/json

post/identity/icp

POST /identity/icp HTTP/1.1
Host: api.getuntitled.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "items": [
    {
      "id": "text",
      "hem": "text",
      "tag_id": "text",
      "email": "text",
      "prediction": 1,
      "percentile": 1
    }
  ],
  "total": 1,
  "page": 1,
  "size": 1,
  "pages": 1
}