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

This call returns list of one or more contacts.

GET https://api.context.io/1.1/contactsearch.json

Parameters

search

String identifying the name or the email address of the contact(s) you are looking for.

Response

The response is a list of contacts:

{
  ...
  data: {
    query: (string) The search query,
    matches: [
      {
        emails: (array) List of known email addresses of associated to the account
	userId: (string) Unique ID of the contact's Context.IO account
        name: (string) name of contact
        me: (boolean) indicating if this is your account
        thumbnail: (string) thumbnail URL
      },
      ...
    ]
  }
}