Getting started
Essentials
Calls
Contact Custom Fields
Contacts
Conversations
Phone Numbers
Contacts
Get a contact by ID
Retrieve detailed information about a specific contact in your OpenPhone workspace using the contact’s unique identifier.
GET
/
v1
/
contacts
/
{id}
Copy
Ask AI
curl --request GET \
--url https://api.openphone.com/v1/contacts/{id} \
--header 'Authorization: <api-key>'
Copy
Ask AI
{
"data": {
"id": "664d0db69fcac7cf2e6ec",
"externalId": "664d0db69fcac7cf2e6ec",
"source": "public-api",
"sourceUrl": "https://openphone.co/contacts/664d0db69fcac7cf2e6ec",
"defaultFields": {
"company": "OpenPhone",
"emails": [
{
"name": "company email",
"value": "[email protected]",
"id": "acb123"
}
],
"firstName": "John",
"lastName": "Doe",
"phoneNumbers": [
{
"name": "company phone",
"value": "+12345678901",
"id": "acb123"
}
],
"role": "Sales"
},
"customFields": [
{
"name": "Inbound Lead",
"key": "inbound-lead",
"id": "66d0d87d534de8fd1c433cec3",
"type": "multi-select",
"value": [
"<string>"
]
}
],
"createdAt": "2022-01-01T00:00:00Z",
"updatedAt": "2022-01-01T00:00:00Z",
"createdByUserId": "US123abc"
}
}
Authorizations
Path Parameters
The unique identifier of the contact.
Examples:
"66d0d87e8dc1211467372303"
Response
200
application/json
Success
The response is of type object
.
Was this page helpful?
Copy
Ask AI
curl --request GET \
--url https://api.openphone.com/v1/contacts/{id} \
--header 'Authorization: <api-key>'
Copy
Ask AI
{
"data": {
"id": "664d0db69fcac7cf2e6ec",
"externalId": "664d0db69fcac7cf2e6ec",
"source": "public-api",
"sourceUrl": "https://openphone.co/contacts/664d0db69fcac7cf2e6ec",
"defaultFields": {
"company": "OpenPhone",
"emails": [
{
"name": "company email",
"value": "[email protected]",
"id": "acb123"
}
],
"firstName": "John",
"lastName": "Doe",
"phoneNumbers": [
{
"name": "company phone",
"value": "+12345678901",
"id": "acb123"
}
],
"role": "Sales"
},
"customFields": [
{
"name": "Inbound Lead",
"key": "inbound-lead",
"id": "66d0d87d534de8fd1c433cec3",
"type": "multi-select",
"value": [
"<string>"
]
}
],
"createdAt": "2022-01-01T00:00:00Z",
"updatedAt": "2022-01-01T00:00:00Z",
"createdByUserId": "US123abc"
}
}
Assistant
Responses are generated using AI and may contain mistakes.