API version:
  • 1.0
  • 1.1
  • 2.0

This API version isn't the latest one.

It is advisable to use the latest API version which contains the latest Context.IO enhancements.

GET threadinfo.json

Returns document and contact information about a given email thread. A thread is identified by the value of the Gmail thread ID.

GET https://api.context.io/1.1/threadinfo.json?gmailthreadid=threadId

Parameters

You can specify either a gmailthreadid or a emailmessageid.

gmailthreadid

The value of the by gmail attributed thread id. When you open a thread (or "conversation") in Gmail, the url looks like https://mail.google.com/mail/#inbox/12c211595b147100. In that URL, 12c211595b147100 is the Gmail thread ID (which also happens to be the Gmail message ID of the first message in the thread).

emailmessageid

The value of the Message-ID header. As specified in the RFC822, the < and > at the beginning and end of the Message-ID are part of the value and should be included in this parameter.

account

The email address of the account you want to get data from. This parameter must be set if your API key has access to more than one email account (see imap/addaccount).

Response

The data portion of the response includes three properties: addresses, personInfo and files:

{
  ...
  data: {
    addresses: [...],
    personInfo: [...],
    files: [...]
  }
}

addresses

Indicates information about the sender and recipient(s) of the message. See message addresses information for more information.

personInfo

Indicates information about the sender and recipient(s) of the message. See message person information for more information.

files

The files property of the response follows the exact same definition as in the messageinfo call. Refer to that documentation page for more details.