Hey! We're Hiring.


A chronological record of events associated with your twin. An event is a link between an object and its timestamp.

Anytime a supported object (memories, quests, tasks, assets) is created, a timeline event is recorded.

You can query the timeline to view this chronological record, and can filter by category or time.

The response will return an event object, with its related ID.

List all timelines

List my timeline

List your connected twins timelines

§List all timelines

This will list all public timelines

curl --location --request GET '<API_URL>/timelines/' \ --header 'Content-Type: application/vnd.api+json' \ --header 'X-Organization: <ORG_ID>' \ --header 'X-Twin: <TWIN_ID>' \ --header 'Authorization: Token <ACCESS_TOKEN>'

Query Parameters

You can filter the responses by twin ID and events

Query ParametersExpected InputDescription
twinIDStringFilter results by Twin ID
eventIDStringFilter and search results by event ID.
created_beforedateFilter results by date
created_afterdateFilter results by date

§List my timeline

This will list your twin’s timeline

curl --location --request GET '<API_URL>/my/timelines/' \ --header 'Content-Type: application/vnd.api+json' \ --header 'X-Organization: <ORG_ID>' \ --header 'X-Twin: <TWIN_ID>' \ --header 'Authorization: Token <ACCESS_TOKEN>'

§List your connected twins timelines

This will list the timelines of your trusted twin’s even if they’re timelines are not public

curl --location --request GET '<API_URL>/connected/timelines/' \ --header 'Content-Type: application/vnd.api+json' \ --header 'X-Organization: <ORG_ID>' \ --header 'X-Twin: <TWIN_ID>' \ --header 'Authorization: Token <ACCESS_TOKEN>'