Search contacts
Contacts of your directory found by name, number or company.
GET https://cotlet.dev/api/v1/ringover/contacts/search
read
Searches the Ringover contact directory by name, phone number or company and returns each match with its numbers. An empty list means no contact matches, which is normal for a first-time caller. Use the number as to_number in send_sms.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | A name, a phone number or a company. |
| limit integer | integer | How many contacts to return. |
Request
curl "https://cotlet.dev/api/v1/ringover/contacts/search?query=query" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("ringover", "search_contacts", {"query":"query"})const result = await cotlet.call('ringover', 'search_contacts', {"query":"query"});cotlet call ringover search_contacts --data '{"query":"query"}'Example response
{
"contacts": [
{
"contact_id": "ct_5528",
"name": "Dana Whitfield",
"company": "Northline Dental",
"numbers": [
"+15550100142"
]
}
]
}