For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
HomepageProduct HelpLog inTry for Free
Developers HomeAPI ReferenceMCP
Developers HomeAPI ReferenceMCP
  • Getting Started
    • Introduction
    • Authentication with API Keys
    • Authentication with OAuth
    • API Clients
    • Pagination
    • Specifying Fields
    • Filter Parameters
    • HTTP Response Codes
    • Rate Limits
    • Timezone Offsets
    • Rich Text Fields
    • Changelog
  • CRM Core
    • Leads
    • Contacts
      • GETList contacts
      • POSTCreate a new contact
      • GETFetch a single contact
      • PUTUpdate an existing contact
      • DELDelete a contact
    • Opportunities
    • Tasks
    • Files
    • Custom Objects
    • Comments
  • Activities
    • Activities
    • Notes
    • Calls
    • Emails
    • Email Threads
    • WhatsApp Messages
    • Meetings
    • Custom Activities
    • Creations
    • Form Submissions
    • Lead Status Changes
    • Opportunity Status Changes
    • Lead Merges
    • Task Completions
  • Events & Webhooks
    • Webhooks
    • Events
  • Search & Reporting
    • Advanced Filtering
    • Smart Views
    • Reporting
  • Automation & Bulk Actions
    • Sequences (Workflows)
    • Bulk Actions
    • Exports
    • AI Field Enrichment
  • CRM Configuration
    • Custom Fields
    • Custom Activity Types
    • Custom Object Types
    • Pipelines
    • Opportunity Statuses
    • Lead Statuses
    • Integration Links
    • Forms
  • Communication Configuration
    • Email Templates
    • SMS Templates
    • Outcomes
    • Playbooks
    • Scheduling Links Guide
    • Scheduling Links
    • Connected Accounts
    • Send As
    • Unsubscribed Emails
    • Phone Numbers
    • Blocked Phone Numbers
    • Dialers
  • Users & Organizations
    • Users
    • Organizations
    • Memberships
    • Roles
    • Groups
Close

Product

OverviewCommunicationAutomationIntegrationsReportingSMSCallingSecurityForms

Pricing & Use Cases

PricingClose vs Other CRMsCustomer Stories

Resources

Sales BlogSales ResourcesSales GuidesWebinarsOn-Demand DemoSales Tools

Company

AboutCareersPartner with CloseBrand GuidelinesTermsPrivacyGDPRCCPA

Get Help

+1-833-GO-CLOSEHelp CenterDownload the Close AppProduct UpdatesSystem Status
LogoLogo
HomepageProduct HelpLog inTry for Free
CRM CoreContacts

List contacts

||View as Markdown|
GET
https://api.close.com/api/v1/contact/
GET
/api/v1/contact/
$curl https://api.close.com/api/v1/contact/ \
>     -u "<CLOSE_API_KEY>:"
1{
2  "data": [
3    {
4      "created_by": null,
5      "date_created": "2013-02-01T00:54:51.300000+00:00",
6      "date_updated": "2013-02-06T20:53:09.334000+00:00",
7      "display_name": "Tobias Fünke",
8      "id": "cont_q4xYmlGhA3060dEl0NDJuHRxPMuVjqLn30AFSzh1fRk",
9      "name": "Tobias Fünke",
10      "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
11      "title": "Blue Man Group (Understudy)",
12      "updated_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
13      "emails": [
14        {
15          "email": "tobiasfunke@close.com",
16          "is_unsubscribed": false,
17          "type": "office"
18        }
19      ],
20      "phones": []
21    },
22    {
23      "created_by": null,
24      "date_created": "2013-02-01T00:54:51.331000+00:00",
25      "date_updated": "2013-02-06T20:53:01.954000+00:00",
26      "display_name": "Bruce Wayne",
27      "id": "cont_o0kP3Nqyq0wxr5DLWIEm8mVr6ZpI0AhonKLDG0V5Qjh",
28      "name": "Bruce Wayne",
29      "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
30      "title": "The Dark Knight",
31      "updated_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
32      "emails": [
33        {
34          "email": "thedarkknight@close.com",
35          "is_unsubscribed": true,
36          "type": "office"
37        }
38      ],
39      "phones": [
40        {
41          "phone": "+16503334444",
42          "type": "office",
43          "country": "US",
44          "phone_formatted": "+1 650-333-4444"
45        }
46      ],
47      "custom.cf_j0P7kHmgFTZZnYBFtyPSZ3uQw4dpW8xKcW7Krps8atj": "CEO"
48    },
49    {
50      "created_by": null,
51      "date_created": "2013-02-01T00:54:51.298000+00:00",
52      "date_updated": "2013-02-06T20:48:55.240000+00:00",
53      "display_name": "Gob Bluth",
54      "id": "cont_E7dYM0ecRoFQosxiPFz8IxazhN4k11uW8Sh1UsXjNjo",
55      "name": "Gob Bluth",
56      "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
57      "title": "Magician",
58      "updated_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
59      "emails": [
60        {
61          "email": "bluth@close.com",
62          "is_unsubscribed": false,
63          "type": "office"
64        }
65      ],
66      "phones": []
67    },
68    {
69      "created_by": null,
70      "date_created": "2013-02-01T00:54:51.203000+00:00",
71      "date_updated": "2013-02-01T00:59:33.689000+00:00",
72      "display_name": "Close Support",
73      "id": "cont_uw6ONU4iBcQg4TyqOKAwl0F1amULG9ZZsY57kHHdJNE",
74      "name": "Close Support",
75      "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
76      "title": null,
77      "updated_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
78      "emails": [
79        {
80          "email": "support@close.com",
81          "is_unsubscribed": false,
82          "type": "office"
83        }
84      ],
85      "phones": [
86        {
87          "phone": "+18552567346",
88          "type": "office",
89          "country": "US",
90          "phone_formatted": "+1 855-256-7346",
91          "is_unsubscribed": false
92        }
93      ]
94    },
95    {
96      "created_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
97      "date_created": "2013-02-08T05:02:39.552000+00:00",
98      "date_updated": "2013-02-08T05:02:39.552000+00:00",
99      "display_name": "phil",
100      "id": "cont_eXZwc2SVL4G3xSR85jnfPny2ykvoAQndSyi1Doa2YLO",
101      "name": "phil",
102      "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
103      "title": "",
104      "updated_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
105      "emails": [
106        {
107          "email": "phil@close.com",
108          "is_unsubscribed": false,
109          "type": "office"
110        }
111      ],
112      "phones": []
113    },
114    {
115      "created_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
116      "date_created": "2013-02-20T05:30:24.844000+00:00",
117      "date_updated": "2013-02-20T05:44:14.700000+00:00",
118      "display_name": "Gob",
119      "id": "cont_qpjDKxbN3WWsuhaJjg2Qr9pkqHqe1yviZ5BS0dEyz05",
120      "name": "Gob",
121      "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
122      "title": "sr. vice president",
123      "updated_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
124      "emails": [
125        {
126          "email": "gob@example.com",
127          "is_unsubscribed": false,
128          "type": "office"
129        }
130      ],
131      "phones": [
132        {
133          "phone": "+18004445555",
134          "type": "office",
135          "country": "US",
136          "phone_formatted": "+1 800-444-5555"
137        }
138      ]
139    },
140    {
141      "created_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
142      "date_created": "2013-02-20T05:44:31.929000+00:00",
143      "date_updated": "2013-02-20T05:44:31.929000+00:00",
144      "display_name": "Gob",
145      "id": "cont_kfaRMPzwQ9yAOn96gVGUxKRKqsYv6QJStoLhlDEpquY",
146      "name": "Gob",
147      "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
148      "title": "sr. vice president",
149      "updated_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
150      "emails": [
151        {
152          "email": "gob@example.com",
153          "is_unsubscribed": false,
154          "type": "office"
155        }
156      ],
157      "phones": [
158        {
159          "phone": "+18004445555",
160          "type": "office",
161          "country": "US",
162          "phone_formatted": "+1 800-444-5555"
163        }
164      ]
165    },
166    {
167      "created_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
168      "date_created": "2013-02-20T05:44:35.625000+00:00",
169      "date_updated": "2013-02-20T05:44:35.625000+00:00",
170      "display_name": "Gob",
171      "id": "cont_3lUrUYmceYjzeqrIqF5jpSppZemyxvgquE8Oq1kM6p0",
172      "name": "Gob",
173      "organization_id": "orga_RbREgmiiwcr1w2b4cOnCMQaQPSIFxMqAD2Dh243uxcH",
174      "title": "sr. vice president",
175      "updated_by": "user_N6KhMpzHRCYQHdn4gRNIFNN5JExnsrprKA6ekxM63XA",
176      "emails": [
177        {
178          "email": "gob@example.com",
179          "is_unsubscribed": false,
180          "type": "office"
181        }
182      ],
183      "phones": [
184        {
185          "phone": "+18004445555",
186          "type": "office",
187          "country": "US",
188          "phone_formatted": "+1 800-444-5555"
189        }
190      ]
191    }
192  ],
193  "has_more": false
194}
Was this page helpful?
Previous

Contacts

Next

Create a new contact

Built with

Authentication

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

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

Query parameters

_limitintegerOptionalDefaults to 100
Number of results to return.
_skipintegerOptionalDefaults to 0
Number of results to skip before returning, for pagination.
_fieldsstringOptional

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

lead_idstringOptional

Response

Successful response
datalist of objects
has_moreboolean

Errors

400
Bad Request Error
401
Unauthorized Error
404
Not Found Error