Fetch a single contact | Close | Developer API Documentation

curl https://api.close.com/api/v1/contact/id/ \
     -u "<CLOSE_API_KEY>:"

{
  "created_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
  "date_created": "2013-02-20T05:44:35.625000+00:00",
  "date_updated": "2013-02-20T05:44:35.625000+00:00",
  "display_name": "Gob",
  "id": "cont_3lUrUYmceYjzeqrIqF5jpSppZemyxvgquE8Oq1kM6p0",
  "name": "Gob",
  "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
  "title": "sr. vice president",
  "updated_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
  "emails": [
    {
      "email": "gob@example.com",
      "is_unsubscribed": false,
      "type": "office"
    }
  ],
  "lead_id": "lead_etYl6PwL12hkj14567kjolJwZuZehb9b85EDH9CKuAI",
  "phones": [
    {
      "phone": "+18004445555",
      "type": "office",
      "country": "US",
      "phone_formatted": "+1 800-444-5555"
    }
  ]
}

curl https://api.close.com/api/v1/contact/id/ \
     -u "<CLOSE_API_KEY>:"

{
  "created_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
  "date_created": "2013-02-20T05:44:35.625000+00:00",
  "date_updated": "2013-02-20T05:44:35.625000+00:00",
  "display_name": "Gob",
  "id": "cont_3lUrUYmceYjzeqrIqF5jpSppZemyxvgquE8Oq1kM6p0",
  "name": "Gob",
  "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
  "title": "sr. vice president",
  "updated_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
  "emails": [
    {
      "email": "gob@example.com",
      "is_unsubscribed": false,
      "type": "office"
    }
  ],
  "lead_id": "lead_etYl6PwL12hkj14567kjolJwZuZehb9b85EDH9CKuAI",
  "phones": [
    {
      "phone": "+18004445555",
      "type": "office",
      "country": "US",
      "phone_formatted": "+1 800-444-5555"
    }
  ]
}

Authentication

AuthorizationBasic

Use your API key as the username and leave the password empty.

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

Query parameters

_fieldsstringOptional

Comma-separated list of fields to include in the response.

Response

Successful response

created_bystring or null

date_createddatetime

date_updateddatetime

display_namestring

idstring

namestring or null

organization_idstring

titlestring or null

updated_bystring or null

emailslist of objects

integration_linkslist of objects

lead_idstring or null

lead_suggestions_operation_idstring or null

phoneslist of objects

recent_callslist of objects

subscriptionslist of objects

timezonestring or null

timezone_sourcestring or null

urlslist of objects

Errors

400

Bad Request Error

401

Unauthorized Error

404

Not Found Error

$	curl https://api.close.com/api/v1/contact/id/ \
>	-u "<CLOSE_API_KEY>:"

1	{
2	"created_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
3	"date_created": "2013-02-20T05:44:35.625000+00:00",
4	"date_updated": "2013-02-20T05:44:35.625000+00:00",
5	"display_name": "Gob",
6	"id": "cont_3lUrUYmceYjzeqrIqF5jpSppZemyxvgquE8Oq1kM6p0",
7	"name": "Gob",
8	"organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
9	"title": "sr. vice president",
10	"updated_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
11	"emails": [
12	{
13	"email": "gob@example.com",
14	"is_unsubscribed": false,
15	"type": "office"
16	}
17	],
18	"lead_id": "lead_etYl6PwL12hkj14567kjolJwZuZehb9b85EDH9CKuAI",
19	"phones": [
20	{
21	"phone": "+18004445555",
22	"type": "office",
23	"country": "US",
24	"phone_formatted": "+1 800-444-5555"
25	}
26	]
27	}