DocsBuilding AppsInstalling IntercomAPI & Webhook ReferenceCanvas Kit Reference
DocsApp StoreForumBlogYour Apps

Retrieve a visitor

Example ID Request

$ curl \
-s https://api.intercom.io/visitors/<id> \   
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept:application/json'

or 

$ curl \
-s https://api.intercom.io/visitors\?user_id\=16e690c0-485a-4e87-ae98-a326e788a4f7 \
-H 'Authorization:Bearer <Your access token>' \
-H 'Accept:application/json'
HTTP/1.1 200 OK

{
  "type": "visitor",
  "id": "573479f784c5acde6a000575",
  "user_id": "16e690c0-485a-4e87-ae98-a326e788a4f7",
  "email": "[email protected]",
  "name": "Winston Smith",
  ...
}
# NB: Full Visitor objects are returned
visitor = intercom.visitors.find(:id => "530370b477ad7120001d")
visitor = intercom.visitors.find(:user_id => "8a88a590-e1c3-41e2-a502-e0649dbf721c")

You can fetch the details of a single visitor.

Request Path Parameters

Parameter

Required?

Description

id

One of

Id provided by Intercom.

?user_id=

One of

To get the visitor user_id from the browser you can use the Intercom JS SDK following method : Intercom('getVisitorId').

Response

This will return a Visitor Model.