> For the complete documentation index, see [llms.txt](https://docs.getuntitled.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getuntitled.ai/api-documentation/identity.md).

# Identity

## List Resolutions

> 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.

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"ResolutionsQuery":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","description":"Start of the date range (YYYY-MM-DD). Defaults to 7 days ago."},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","description":"End of the date range (YYYY-MM-DD). Defaults to today."},"filters":{"anyOf":[{"$ref":"#/components/schemas/ApiFilters"},{"type":"null"}],"description":"Narrows results by visitor attributes, sessions, pages, buyer intent, enrichment data, or ML scores. All filter entities are supported: visitors, sessions, pages, buyer_intent, enrichment, and ml."}},"type":"object","title":"ResolutionsQuery"},"ApiFilters":{"properties":{"visitors":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Visitors"},"sessions":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Sessions"},"pages":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Pages"},"buyer_intent":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Buyer Intent"},"enrichment":{"additionalProperties":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array"},"type":"object","title":"Enrichment","description":"Nested by enrichment source, e.g. {\"klaviyo\": [...], \"shopify\": [...]}."},"ml":{"additionalProperties":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array"},"type":"object","title":"Ml","description":"Nested by ML model name, e.g. {\"icp\": [...]}."}},"additionalProperties":false,"type":"object","title":"ApiFilters","description":"Top-level filter payload, grouped by entity.\n\nAll lists default to empty so callers only need to populate the entities\nthey actually filter on."},"FilterCondition":{"properties":{"field":{"type":"string","title":"Field","description":"Column to filter on. Must be in the allowlist for the parent entity."},"method":{"$ref":"#/components/schemas/Operator","description":"Comparison method. Accepts word-style names ('equals', 'contains', …) or SQL symbols ('=', '!=', '<', '<=', '>', '>=', 'like', 'not like', 'in', 'not in', 'is null', 'is not null'). Case-insensitive."},"value":{"title":"Value","description":"Value to compare against. List for IN/NOT_IN. Ignored for IS_NULL/IS_NOT_NULL."}},"additionalProperties":false,"type":"object","required":["field","method"],"title":"FilterCondition","description":"A single filter clause: ``{field, method, value}``.\n\n``method`` accepts word-style names (``equals``, ``contains``, …) or SQL\nsymbols (``=``, ``!=``, ``like``, ``in``, …) in any case.\n\nFor ``in`` / ``not_in``, ``value`` must be a list. For ``is_null`` /\n``is_not_null``, ``value`` is ignored and may be omitted."},"Operator":{"type":"string","enum":["equals","not_equals","less_than","less_than_or_equal","greater_than","greater_than_or_equal","contains","not_contains","starts_with","not_starts_with","ends_with","not_ends_with","in","not_in","is_null","is_not_null"],"title":"Operator","description":"Canonical word-style comparison operators used internally.\n\nEach value maps to a SQL operator in\n``integrations.api.validators.OPERATOR_TO_SQL``."},"ResolutionsPageResponse":{"properties":{"items":{"items":{"$ref":"#/components/schemas/ResolutionsResponse"},"type":"array","title":"Items"},"page":{"type":"integer","title":"Page"},"size":{"type":"integer","title":"Size"},"total":{"type":"integer","title":"Total"},"pages":{"type":"integer","title":"Pages"}},"type":"object","required":["items","page","size","total","pages"],"title":"ResolutionsPageResponse","description":"Paginated resolutions list returned by the Identity API."},"ResolutionsResponse":{"properties":{"hem":{"type":"string","title":"Hem","description":"hashed email identifier"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email","description":"email address associated with this visitor"},"personal_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Email"},"business_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Email","description":"business email address"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"age_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Age Range"},"married":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Married"},"income_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Income Range"},"net_worth":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Net Worth"},"homeowner":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Homeowner"},"personal_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Address"},"personal_address2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Address2"},"personal_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal City"},"personal_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal State"},"personal_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Zip"},"personal_zip4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Zip4"},"personal_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Phone"},"mobile_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mobile Phone"},"job_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Title"},"seniority_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seniority Level"},"department":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Department"},"professional_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Address"},"professional_address2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Address2"},"professional_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional City"},"professional_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional State"},"professional_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Zip"},"professional_zip4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Zip4"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"company_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Domain"},"company_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Phone"},"company_sic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Sic"},"company_naics":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Naics"},"company_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Address"},"company_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company City"},"company_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company State"},"company_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Zip"},"company_linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Linkedin Url"},"company_revenue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Revenue"},"company_employee_count":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Employee Count"},"primary_industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Industry"},"ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip"},"tag_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Id","description":"Tag ID from the visitor's latest session"},"file_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Type","description":"Resolution file type (b2b, b2c, pte)"},"last_session_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Last Session Date","description":"End time of the visitor's most recent session"},"last_session_total_pages_visited":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Session Total Pages Visited","description":"Pages visited in the most recent session"},"total_session_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Session Count","description":"Total sessions for this visitor and tag"},"last_session_entry_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Session Entry Url","description":"Entry URL of the most recent session"},"last_session_entry_referer_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Session Entry Referer Url","description":"Entry referer URL of the most recent session"},"last_session_exit_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Session Exit Url","description":"Exit URL of the most recent session"},"last_session_est_duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Last Session Est Duration","description":"Estimated duration of the most recent session (seconds)"},"lead_category":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Lead Category","description":"Lead score category (e.g. hot, warm, cold)"},"business_email_validation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Email Validation Status"},"business_email_last_seen":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Business Email Last Seen"},"personal_email_validation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Email Validation Status"},"personal_email_last_seen":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Personal Email Last Seen"}},"type":"object","required":["hem","business_email"],"title":"ResolutionsResponse","description":"Resolutions Response with system variables removed."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/resolutions":{"post":{"tags":["Identity"],"summary":"List Resolutions","description":"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.","operationId":"get_resolutions_identity_resolutions_post","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":10,"title":"Size"},"description":"Page size"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolutionsQuery"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolutionsPageResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Count Resolutions

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

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"ResolutionsQuery":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","description":"Start of the date range (YYYY-MM-DD). Defaults to 7 days ago."},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","description":"End of the date range (YYYY-MM-DD). Defaults to today."},"filters":{"anyOf":[{"$ref":"#/components/schemas/ApiFilters"},{"type":"null"}],"description":"Narrows results by visitor attributes, sessions, pages, buyer intent, enrichment data, or ML scores. All filter entities are supported: visitors, sessions, pages, buyer_intent, enrichment, and ml."}},"type":"object","title":"ResolutionsQuery"},"ApiFilters":{"properties":{"visitors":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Visitors"},"sessions":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Sessions"},"pages":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Pages"},"buyer_intent":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array","title":"Buyer Intent"},"enrichment":{"additionalProperties":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array"},"type":"object","title":"Enrichment","description":"Nested by enrichment source, e.g. {\"klaviyo\": [...], \"shopify\": [...]}."},"ml":{"additionalProperties":{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array"},"type":"object","title":"Ml","description":"Nested by ML model name, e.g. {\"icp\": [...]}."}},"additionalProperties":false,"type":"object","title":"ApiFilters","description":"Top-level filter payload, grouped by entity.\n\nAll lists default to empty so callers only need to populate the entities\nthey actually filter on."},"FilterCondition":{"properties":{"field":{"type":"string","title":"Field","description":"Column to filter on. Must be in the allowlist for the parent entity."},"method":{"$ref":"#/components/schemas/Operator","description":"Comparison method. Accepts word-style names ('equals', 'contains', …) or SQL symbols ('=', '!=', '<', '<=', '>', '>=', 'like', 'not like', 'in', 'not in', 'is null', 'is not null'). Case-insensitive."},"value":{"title":"Value","description":"Value to compare against. List for IN/NOT_IN. Ignored for IS_NULL/IS_NOT_NULL."}},"additionalProperties":false,"type":"object","required":["field","method"],"title":"FilterCondition","description":"A single filter clause: ``{field, method, value}``.\n\n``method`` accepts word-style names (``equals``, ``contains``, …) or SQL\nsymbols (``=``, ``!=``, ``like``, ``in``, …) in any case.\n\nFor ``in`` / ``not_in``, ``value`` must be a list. For ``is_null`` /\n``is_not_null``, ``value`` is ignored and may be omitted."},"Operator":{"type":"string","enum":["equals","not_equals","less_than","less_than_or_equal","greater_than","greater_than_or_equal","contains","not_contains","starts_with","not_starts_with","ends_with","not_ends_with","in","not_in","is_null","is_not_null"],"title":"Operator","description":"Canonical word-style comparison operators used internally.\n\nEach value maps to a SQL operator in\n``integrations.api.validators.OPERATOR_TO_SQL``."},"ResolutionsCountResponse":{"properties":{"b2b":{"type":"integer","title":"B2B","default":0},"b2c":{"type":"integer","title":"B2C","default":0},"pte":{"type":"integer","title":"Pte","default":0},"total":{"type":"integer","title":"Total","readOnly":true}},"additionalProperties":true,"type":"object","required":["total"],"title":"ResolutionsCountResponse","description":"Count of resolutions for the given date range and filters."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/resolutions/count":{"post":{"tags":["Identity"],"summary":"Count Resolutions","description":"Returns visitor counts grouped by record type (`b2b`, `b2c`, `pte`) for the given date range — useful for dashboards and usage tracking.","operationId":"get_total_count_identity_resolutions_count_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolutionsQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolutionsCountResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Get Billing Breakdown

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

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"DateRangeQuery":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","description":"Start of the date range (YYYY-MM-DD). Defaults to 7 days ago."},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","description":"End of the date range (YYYY-MM-DD). Defaults to today."}},"type":"object","title":"DateRangeQuery"},"ResolutionsBillingResponse":{"properties":{"event_date":{"type":"string","format":"date","title":"Event Date"},"tag_id":{"type":"string","title":"Tag Id"},"file_type":{"type":"string","title":"File Type"},"visitor_count":{"type":"integer","title":"Visitor Count"}},"additionalProperties":true,"type":"object","required":["event_date","tag_id","file_type","visitor_count"],"title":"ResolutionsBillingResponse","description":"Billing count of resolutions by day, tag_id, and file_type for the given date range."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/resolutions/billing":{"post":{"tags":["Identity"],"summary":"Get Billing Breakdown","description":"Returns daily unique visitor counts broken down by tag and record type. Useful for building usage and billing charts.","operationId":"get_resolutions_billing_identity_resolutions_billing_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DateRangeQuery"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ResolutionsBillingResponse"},"type":"array","title":"Response Get Resolutions Billing Identity Resolutions Billing Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## List Visitors

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

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"VisitorQuery":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","description":"Start of the date range (YYYY-MM-DD). Defaults to 7 days ago."},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","description":"End of the date range (YYYY-MM-DD). Defaults to today."},"filters":{"anyOf":[{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array"},{"type":"null"}],"title":"Filters","description":"Narrows results by visitor attributes such as name, company, location, or job title."}},"type":"object","title":"VisitorQuery"},"FilterCondition":{"properties":{"field":{"type":"string","title":"Field","description":"Column to filter on. Must be in the allowlist for the parent entity."},"method":{"$ref":"#/components/schemas/Operator","description":"Comparison method. Accepts word-style names ('equals', 'contains', …) or SQL symbols ('=', '!=', '<', '<=', '>', '>=', 'like', 'not like', 'in', 'not in', 'is null', 'is not null'). Case-insensitive."},"value":{"title":"Value","description":"Value to compare against. List for IN/NOT_IN. Ignored for IS_NULL/IS_NOT_NULL."}},"additionalProperties":false,"type":"object","required":["field","method"],"title":"FilterCondition","description":"A single filter clause: ``{field, method, value}``.\n\n``method`` accepts word-style names (``equals``, ``contains``, …) or SQL\nsymbols (``=``, ``!=``, ``like``, ``in``, …) in any case.\n\nFor ``in`` / ``not_in``, ``value`` must be a list. For ``is_null`` /\n``is_not_null``, ``value`` is ignored and may be omitted."},"Operator":{"type":"string","enum":["equals","not_equals","less_than","less_than_or_equal","greater_than","greater_than_or_equal","contains","not_contains","starts_with","not_starts_with","ends_with","not_ends_with","in","not_in","is_null","is_not_null"],"title":"Operator","description":"Canonical word-style comparison operators used internally.\n\nEach value maps to a SQL operator in\n``integrations.api.validators.OPERATOR_TO_SQL``."},"Page_VisitorResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/VisitorResponse"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0,"title":"Total"},"page":{"type":"integer","minimum":1,"title":"Page"},"size":{"type":"integer","minimum":1,"title":"Size"},"pages":{"type":"integer","minimum":0,"title":"Pages"}},"type":"object","required":["items","total","page","size","pages"],"title":"Page[VisitorResponse]"},"VisitorResponse":{"properties":{"hem":{"type":"string","title":"Hem"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"record_uuid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Record Uuid"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"business_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Email"},"mobile_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mobile Phone"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url"},"personal_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Address"},"personal_address2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Address2"},"personal_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal City"},"personal_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal State"},"personal_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Zip"},"personal_zip4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Zip4"},"personal_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Email"},"personal_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Phone"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"age_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Age Range"},"married":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Married"},"income_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Income Range"},"net_worth":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Net Worth"},"homeowner":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Homeowner"},"job_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Title"},"seniority_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seniority Level"},"department":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Department"},"professional_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Address"},"professional_address2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Address2"},"professional_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional City"},"professional_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional State"},"professional_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Zip"},"professional_zip4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Zip4"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"company_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Domain"},"company_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Phone"},"company_sic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Sic"},"company_naics":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Naics"},"company_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Address"},"company_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company City"},"company_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company State"},"company_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Zip"},"company_linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Linkedin Url"},"company_revenue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Revenue"},"company_employee_count":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Employee Count"},"primary_industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Industry"},"business_email_validation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Email Validation Status"},"business_email_last_seen":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Business Email Last Seen"},"personal_email_validation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Email Validation Status"},"personal_email_last_seen":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Personal Email Last Seen"},"ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","readOnly":true}},"type":"object","required":["hem","updated_at"],"title":"VisitorResponse","description":"Visitor profile returned by the Identity API."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/visitors":{"post":{"tags":["Identity"],"summary":"List Visitors","description":"Returns a paginated list of visitor profiles, optionally filtered by date range and visitor attributes.","operationId":"get_visitors_identity_visitors_post","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":50,"title":"Size"},"description":"Page size"},{"name":"sort","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","description":"Sort order","default":"desc","title":"Sort"},"description":"Sort order"}],"requestBody":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/VisitorQuery"},{"type":"null"}],"title":"Query"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_VisitorResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Get Visitor

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

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"VisitorResponse":{"properties":{"hem":{"type":"string","title":"Hem"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"record_uuid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Record Uuid"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"business_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Email"},"mobile_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mobile Phone"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url"},"personal_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Address"},"personal_address2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Address2"},"personal_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal City"},"personal_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal State"},"personal_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Zip"},"personal_zip4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Zip4"},"personal_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Email"},"personal_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Phone"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"age_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Age Range"},"married":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Married"},"income_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Income Range"},"net_worth":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Net Worth"},"homeowner":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Homeowner"},"job_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Title"},"seniority_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seniority Level"},"department":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Department"},"professional_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Address"},"professional_address2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Address2"},"professional_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional City"},"professional_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional State"},"professional_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Zip"},"professional_zip4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Zip4"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"company_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Domain"},"company_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Phone"},"company_sic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Sic"},"company_naics":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Naics"},"company_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Address"},"company_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company City"},"company_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company State"},"company_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Zip"},"company_linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Linkedin Url"},"company_revenue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Revenue"},"company_employee_count":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Employee Count"},"primary_industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Industry"},"business_email_validation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Email Validation Status"},"business_email_last_seen":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Business Email Last Seen"},"personal_email_validation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Email Validation Status"},"personal_email_last_seen":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Personal Email Last Seen"},"ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","readOnly":true}},"type":"object","required":["hem","updated_at"],"title":"VisitorResponse","description":"Visitor profile returned by the Identity API."},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/visitors/{email}":{"get":{"tags":["Identity"],"summary":"Get Visitor","description":"Returns the full enriched profile for a single visitor — contact info, company details, demographics, and more. Returns `404` if the visitor is not found.","operationId":"get_profile_identity_visitors__email__get","parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string","title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VisitorResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Get Visitor Profile

> 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).

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"VisitorProfileResponse":{"properties":{"visitor":{"$ref":"#/components/schemas/VisitorResponse"},"sessions":{"items":{"$ref":"#/components/schemas/SessionWithPagesResponse"},"type":"array","title":"Sessions"}},"type":"object","required":["visitor","sessions"],"title":"VisitorProfileResponse","description":"Full visitor profile with recent sessions and their page views."},"VisitorResponse":{"properties":{"hem":{"type":"string","title":"Hem"},"email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Email"},"record_uuid":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Record Uuid"},"first_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"First Name"},"last_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Name"},"business_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Email"},"mobile_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mobile Phone"},"linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Linkedin Url"},"personal_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Address"},"personal_address2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Address2"},"personal_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal City"},"personal_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal State"},"personal_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Zip"},"personal_zip4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Zip4"},"personal_email":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Email"},"personal_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Phone"},"gender":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Gender"},"age_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Age Range"},"married":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Married"},"income_range":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Income Range"},"net_worth":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Net Worth"},"homeowner":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Homeowner"},"job_title":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Job Title"},"seniority_level":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Seniority Level"},"department":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Department"},"professional_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Address"},"professional_address2":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Address2"},"professional_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional City"},"professional_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional State"},"professional_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Zip"},"professional_zip4":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Professional Zip4"},"company_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Name"},"company_domain":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Domain"},"company_phone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Phone"},"company_sic":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Sic"},"company_naics":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Naics"},"company_address":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Address"},"company_city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company City"},"company_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company State"},"company_zip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Zip"},"company_linkedin_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Linkedin Url"},"company_revenue":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Revenue"},"company_employee_count":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Company Employee Count"},"primary_industry":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Primary Industry"},"business_email_validation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Business Email Validation Status"},"business_email_last_seen":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Business Email Last Seen"},"personal_email_validation_status":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Personal Email Validation Status"},"personal_email_last_seen":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Personal Email Last Seen"},"ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","readOnly":true}},"type":"object","required":["hem","updated_at"],"title":"VisitorResponse","description":"Visitor profile returned by the Identity API."},"SessionWithPagesResponse":{"properties":{"id":{"type":"string","title":"Id"},"hem":{"type":"string","title":"Hem"},"tag_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Id"},"file_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Type"},"session_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Session Start"},"session_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Session End"},"est_session_duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Est Session Duration"},"entry_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entry Url"},"entry_referer_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entry Referer Url"},"exit_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exit Url"},"total_pages_visited":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Pages Visited"},"unique_pages_visited":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Unique Pages Visited"},"pages":{"items":{"$ref":"#/components/schemas/PageViewResponse"},"type":"array","title":"Pages","default":[]},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","readOnly":true}},"type":"object","required":["id","hem","updated_at"],"title":"SessionWithPagesResponse","description":"Session record with its associated page views nested."},"PageViewResponse":{"properties":{"id":{"type":"string","title":"Id"},"hem":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hem"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Id"},"tag_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Id"},"file_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Type"},"ref_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref Url"},"referer_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referer Url"},"est_time_on_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Est Time On Page"},"event_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Event Date"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","readOnly":true}},"type":"object","required":["id","updated_at"],"title":"PageViewResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/visitors/{email}/profile":{"get":{"tags":["Identity"],"summary":"Get Visitor Profile","description":"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).","operationId":"get_visitor_profile_identity_visitors__email__profile_get","parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string","title":"Email"}},{"name":"session_limit","in":"query","required":false,"schema":{"type":"integer","maximum":10,"minimum":1,"description":"Number of recent sessions to include. Max 10.","default":5,"title":"Session Limit"},"description":"Number of recent sessions to include. Max 10."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VisitorProfileResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Get Visitor Sessions

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

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"Page_SessionResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/SessionResponse"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0,"title":"Total"},"page":{"type":"integer","minimum":1,"title":"Page"},"size":{"type":"integer","minimum":1,"title":"Size"},"pages":{"type":"integer","minimum":0,"title":"Pages"}},"type":"object","required":["items","total","page","size","pages"],"title":"Page[SessionResponse]"},"SessionResponse":{"properties":{"id":{"type":"string","title":"Id"},"hem":{"type":"string","title":"Hem"},"tag_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Id"},"file_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Type"},"session_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Session Start"},"session_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Session End"},"est_session_duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Est Session Duration"},"entry_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entry Url"},"entry_referer_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entry Referer Url"},"exit_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exit Url"},"total_pages_visited":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Pages Visited"},"unique_pages_visited":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Unique Pages Visited"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","readOnly":true}},"type":"object","required":["id","hem","updated_at"],"title":"SessionResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/visitors/{email}/sessions":{"get":{"tags":["Identity"],"summary":"Get Visitor Sessions","description":"Returns the visitor's site sessions, most recent first.","operationId":"get_sessions_by_email_identity_visitors__email__sessions_get","parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string","title":"Email"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":50,"title":"Size"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_SessionResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Get Session Page Views

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

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"Page_PageViewResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PageViewResponse"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0,"title":"Total"},"page":{"type":"integer","minimum":1,"title":"Page"},"size":{"type":"integer","minimum":1,"title":"Size"},"pages":{"type":"integer","minimum":0,"title":"Pages"}},"type":"object","required":["items","total","page","size","pages"],"title":"Page[PageViewResponse]"},"PageViewResponse":{"properties":{"id":{"type":"string","title":"Id"},"hem":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hem"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Id"},"tag_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Id"},"file_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Type"},"ref_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref Url"},"referer_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referer Url"},"est_time_on_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Est Time On Page"},"event_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Event Date"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","readOnly":true}},"type":"object","required":["id","updated_at"],"title":"PageViewResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/visitors/{email}/sessions/{session_id}/pages":{"get":{"tags":["Identity"],"summary":"Get Session Page Views","description":"Returns the pages the visitor viewed during a specific session, in the order they were visited.","operationId":"get_session_pages_identity_visitors__email__sessions__session_id__pages_get","parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string","title":"Email"}},{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":50,"title":"Size"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_PageViewResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Get Visitor Page Views

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

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"Page_PageViewResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PageViewResponse"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0,"title":"Total"},"page":{"type":"integer","minimum":1,"title":"Page"},"size":{"type":"integer","minimum":1,"title":"Size"},"pages":{"type":"integer","minimum":0,"title":"Pages"}},"type":"object","required":["items","total","page","size","pages"],"title":"Page[PageViewResponse]"},"PageViewResponse":{"properties":{"id":{"type":"string","title":"Id"},"hem":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hem"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Id"},"tag_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Id"},"file_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Type"},"ref_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref Url"},"referer_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referer Url"},"est_time_on_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Est Time On Page"},"event_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Event Date"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","readOnly":true}},"type":"object","required":["id","updated_at"],"title":"PageViewResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/visitors/{email}/pages":{"get":{"tags":["Identity"],"summary":"Get Visitor Page Views","description":"Returns all pages the visitor has viewed across every session, most recent first.","operationId":"get_pages_by_email_identity_visitors__email__pages_get","parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string","title":"Email"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":50,"title":"Size"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_PageViewResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Get Visitor Buyer Intent

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

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"BuyerIntentResponse":{"properties":{"id":{"type":"string","title":"Id"},"hem":{"type":"string","title":"Hem"},"tag_id":{"type":"string","title":"Tag Id"},"lead_category":{"type":"string","title":"Lead Category"}},"type":"object","required":["id","hem","tag_id","lead_category"],"title":"BuyerIntentResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/visitors/{email}/buyer-intent":{"get":{"tags":["Identity"],"summary":"Get Visitor Buyer Intent","description":"Returns the buyer intent score (`hot`, `warm`, or `cold`) for the visitor.","operationId":"get_buyer_intent_by_email_identity_visitors__email__buyer_intent_get","parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string","title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/BuyerIntentResponse"},"title":"Response Get Buyer Intent By Email Identity Visitors  Email  Buyer Intent Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Get Visitor ICP Score

> 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.

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"IcpResponse":{"properties":{"id":{"type":"string","title":"Id"},"hem":{"type":"string","title":"Hem"},"tag_id":{"type":"string","title":"Tag Id"},"email":{"type":"string","title":"Email"},"prediction":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Prediction"},"percentile":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentile"}},"type":"object","required":["id","hem","tag_id","email"],"title":"IcpResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/visitors/{email}/icp":{"get":{"tags":["Identity"],"summary":"Get Visitor ICP Score","description":"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.","operationId":"get_icp_by_email_identity_visitors__email__icp_get","parameters":[{"name":"email","in":"path","required":true,"schema":{"type":"string","title":"Email"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IcpResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## List Sessions

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

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"SessionQuery":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","description":"Start of the date range (YYYY-MM-DD). Defaults to 7 days ago."},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","description":"End of the date range (YYYY-MM-DD). Defaults to today."},"filters":{"anyOf":[{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array"},{"type":"null"}],"title":"Filters","description":"Narrows results by session attributes such as file_type, tag_id, or engagement percentile."}},"type":"object","title":"SessionQuery"},"FilterCondition":{"properties":{"field":{"type":"string","title":"Field","description":"Column to filter on. Must be in the allowlist for the parent entity."},"method":{"$ref":"#/components/schemas/Operator","description":"Comparison method. Accepts word-style names ('equals', 'contains', …) or SQL symbols ('=', '!=', '<', '<=', '>', '>=', 'like', 'not like', 'in', 'not in', 'is null', 'is not null'). Case-insensitive."},"value":{"title":"Value","description":"Value to compare against. List for IN/NOT_IN. Ignored for IS_NULL/IS_NOT_NULL."}},"additionalProperties":false,"type":"object","required":["field","method"],"title":"FilterCondition","description":"A single filter clause: ``{field, method, value}``.\n\n``method`` accepts word-style names (``equals``, ``contains``, …) or SQL\nsymbols (``=``, ``!=``, ``like``, ``in``, …) in any case.\n\nFor ``in`` / ``not_in``, ``value`` must be a list. For ``is_null`` /\n``is_not_null``, ``value`` is ignored and may be omitted."},"Operator":{"type":"string","enum":["equals","not_equals","less_than","less_than_or_equal","greater_than","greater_than_or_equal","contains","not_contains","starts_with","not_starts_with","ends_with","not_ends_with","in","not_in","is_null","is_not_null"],"title":"Operator","description":"Canonical word-style comparison operators used internally.\n\nEach value maps to a SQL operator in\n``integrations.api.validators.OPERATOR_TO_SQL``."},"Page_SessionResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/SessionResponse"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0,"title":"Total"},"page":{"type":"integer","minimum":1,"title":"Page"},"size":{"type":"integer","minimum":1,"title":"Size"},"pages":{"type":"integer","minimum":0,"title":"Pages"}},"type":"object","required":["items","total","page","size","pages"],"title":"Page[SessionResponse]"},"SessionResponse":{"properties":{"id":{"type":"string","title":"Id"},"hem":{"type":"string","title":"Hem"},"tag_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Id"},"file_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Type"},"session_start":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Session Start"},"session_end":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Session End"},"est_session_duration":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Est Session Duration"},"entry_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entry Url"},"entry_referer_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Entry Referer Url"},"exit_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Exit Url"},"total_pages_visited":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Pages Visited"},"unique_pages_visited":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Unique Pages Visited"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","readOnly":true}},"type":"object","required":["id","hem","updated_at"],"title":"SessionResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/sessions":{"post":{"tags":["Identity"],"summary":"List Sessions","description":"Returns a paginated list of site sessions across all visitors for the given date range.","operationId":"get_sessions_identity_sessions_post","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":50,"title":"Size"},"description":"Page size"},{"name":"sort","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","description":"Sort by session_end","default":"desc","title":"Sort"},"description":"Sort by session_end"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SessionQuery"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_SessionResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## Get Session Page Views

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

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"Page_PageViewResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PageViewResponse"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0,"title":"Total"},"page":{"type":"integer","minimum":1,"title":"Page"},"size":{"type":"integer","minimum":1,"title":"Size"},"pages":{"type":"integer","minimum":0,"title":"Pages"}},"type":"object","required":["items","total","page","size","pages"],"title":"Page[PageViewResponse]"},"PageViewResponse":{"properties":{"id":{"type":"string","title":"Id"},"hem":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hem"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Id"},"tag_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Id"},"file_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Type"},"ref_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref Url"},"referer_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referer Url"},"est_time_on_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Est Time On Page"},"event_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Event Date"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","readOnly":true}},"type":"object","required":["id","updated_at"],"title":"PageViewResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/sessions/{session_id}/pages":{"get":{"tags":["Identity"],"summary":"Get Session Page Views","description":"Returns the pages viewed in a specific session, in chronological order.","operationId":"get_pages_by_session_identity_sessions__session_id__pages_get","parameters":[{"name":"session_id","in":"path","required":true,"schema":{"type":"string","title":"Session Id"}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":50,"title":"Size"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_PageViewResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## List Page Views

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

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"PageQuery":{"properties":{"start_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Start Date","description":"Start of the date range (YYYY-MM-DD). Defaults to 7 days ago."},"end_date":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"End Date","description":"End of the date range (YYYY-MM-DD). Defaults to today."},"filters":{"anyOf":[{"items":{"$ref":"#/components/schemas/FilterCondition"},"type":"array"},{"type":"null"}],"title":"Filters","description":"Narrows results by page attributes such as ref_url or referer_url."}},"type":"object","title":"PageQuery"},"FilterCondition":{"properties":{"field":{"type":"string","title":"Field","description":"Column to filter on. Must be in the allowlist for the parent entity."},"method":{"$ref":"#/components/schemas/Operator","description":"Comparison method. Accepts word-style names ('equals', 'contains', …) or SQL symbols ('=', '!=', '<', '<=', '>', '>=', 'like', 'not like', 'in', 'not in', 'is null', 'is not null'). Case-insensitive."},"value":{"title":"Value","description":"Value to compare against. List for IN/NOT_IN. Ignored for IS_NULL/IS_NOT_NULL."}},"additionalProperties":false,"type":"object","required":["field","method"],"title":"FilterCondition","description":"A single filter clause: ``{field, method, value}``.\n\n``method`` accepts word-style names (``equals``, ``contains``, …) or SQL\nsymbols (``=``, ``!=``, ``like``, ``in``, …) in any case.\n\nFor ``in`` / ``not_in``, ``value`` must be a list. For ``is_null`` /\n``is_not_null``, ``value`` is ignored and may be omitted."},"Operator":{"type":"string","enum":["equals","not_equals","less_than","less_than_or_equal","greater_than","greater_than_or_equal","contains","not_contains","starts_with","not_starts_with","ends_with","not_ends_with","in","not_in","is_null","is_not_null"],"title":"Operator","description":"Canonical word-style comparison operators used internally.\n\nEach value maps to a SQL operator in\n``integrations.api.validators.OPERATOR_TO_SQL``."},"Page_PageViewResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/PageViewResponse"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0,"title":"Total"},"page":{"type":"integer","minimum":1,"title":"Page"},"size":{"type":"integer","minimum":1,"title":"Size"},"pages":{"type":"integer","minimum":0,"title":"Pages"}},"type":"object","required":["items","total","page","size","pages"],"title":"Page[PageViewResponse]"},"PageViewResponse":{"properties":{"id":{"type":"string","title":"Id"},"hem":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hem"},"session_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Session Id"},"external_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Id"},"tag_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tag Id"},"file_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"File Type"},"ref_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ref Url"},"referer_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Referer Url"},"est_time_on_page":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Est Time On Page"},"event_date":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Event Date"},"updated_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Updated At","readOnly":true}},"type":"object","required":["id","updated_at"],"title":"PageViewResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/pages":{"post":{"tags":["Identity"],"summary":"List Page Views","description":"Returns a paginated list of page views across all visitors for the given date range.","operationId":"get_pages_identity_pages_post","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":50,"title":"Size"},"description":"Page size"},{"name":"sort","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","description":"Sort by event_date","default":"desc","title":"Sort"},"description":"Sort by event_date"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PageQuery"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_PageViewResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## List Buyer Intent

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

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"Page_BuyerIntentResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/BuyerIntentResponse"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0,"title":"Total"},"page":{"type":"integer","minimum":1,"title":"Page"},"size":{"type":"integer","minimum":1,"title":"Size"},"pages":{"type":"integer","minimum":0,"title":"Pages"}},"type":"object","required":["items","total","page","size","pages"],"title":"Page[BuyerIntentResponse]"},"BuyerIntentResponse":{"properties":{"id":{"type":"string","title":"Id"},"hem":{"type":"string","title":"Hem"},"tag_id":{"type":"string","title":"Tag Id"},"lead_category":{"type":"string","title":"Lead Category"}},"type":"object","required":["id","hem","tag_id","lead_category"],"title":"BuyerIntentResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/buyer-intent":{"post":{"tags":["Identity"],"summary":"List Buyer Intent","description":"Returns buyer intent records (lead categories) across your workspace.","operationId":"get_buyer_intent_identity_buyer_intent_post","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":50,"title":"Size"},"description":"Page size"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_BuyerIntentResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```

## List ICP Scores

> Returns ICP scores for all visitors, sorted by percentile.

```json
{"openapi":"3.1.0","info":{"title":"Untitled API","version":"βeta"},"servers":[{"url":"https://api.getuntitled.ai","description":"Production"}],"security":[{"Bearer":[]}],"components":{"securitySchemes":{"Bearer":{"type":"http","description":"Bearer token for authentication","scheme":"bearer"}},"schemas":{"Page_IcpResponse_":{"properties":{"items":{"items":{"$ref":"#/components/schemas/IcpResponse"},"type":"array","title":"Items"},"total":{"type":"integer","minimum":0,"title":"Total"},"page":{"type":"integer","minimum":1,"title":"Page"},"size":{"type":"integer","minimum":1,"title":"Size"},"pages":{"type":"integer","minimum":0,"title":"Pages"}},"type":"object","required":["items","total","page","size","pages"],"title":"Page[IcpResponse]"},"IcpResponse":{"properties":{"id":{"type":"string","title":"Id"},"hem":{"type":"string","title":"Hem"},"tag_id":{"type":"string","title":"Tag Id"},"email":{"type":"string","title":"Email"},"prediction":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Prediction"},"percentile":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Percentile"}},"type":"object","required":["id","hem","tag_id","email"],"title":"IcpResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/identity/icp":{"post":{"tags":["Identity"],"summary":"List ICP Scores","description":"Returns ICP scores for all visitors, sorted by percentile.","operationId":"get_icp_identity_icp_post","parameters":[{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"description":"Page number","default":1,"title":"Page"},"description":"Page number"},{"name":"size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Page size","default":50,"title":"Size"},"description":"Page size"},{"name":"sort","in":"query","required":false,"schema":{"enum":["asc","desc"],"type":"string","description":"Sort by percentile","default":"desc","title":"Sort"},"description":"Sort by percentile"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Page_IcpResponse_"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.getuntitled.ai/api-documentation/identity.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.