List contacts

Search contacts (customers and vendors) by name, email or company.

GET https://cotlet.dev/api/v1/odoo/contacts

read

Returns contacts with their ID, name, email, phone and company. Use contact_id from each item for create_draft_invoice and create_sales_order. An empty result means no contact matches, which is the cue to call create_contact.

Parameters

Parameters: list_contacts
NameTypeDescription
query string string Text to match against name or email.
is_company boolean boolean true: only companies; false: only people.
limit integer integer 1 to 100. Default: 50.
offset integer integer Number of records to skip, for the next page. Default: 0.

Request

cURL
curl https://cotlet.dev/api/v1/odoo/contacts \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("odoo", "list_contacts")
Node.js
const result = await cotlet.call('odoo', 'list_contacts');
CLI
cotlet call odoo list_contacts

Example response

JSON

{
  "items": [
    {
      "contact_id": 931,
      "name": "Northwind Studio",
      "email": "billing@northwind.example",
      "phone": "+49 30 555 0142",
      "is_company": true
    }
  ],
  "total": 1
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.