List contacts

Read the contacts saved in one of your lists, or in all of them.

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

read

Returns each contact with its ID, name, email, LinkedIn URL, company and job title, with totals for the list. The tool reads contacts only; it does not add them to a list. Reading contacts is free.

Parameters

Parameters: list_contacts
NameTypeDescription
list_id integer integer List ID from list_contact_lists. Omit or pass 0 for all contacts.

Request

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

Example response

JSON

{
  "recordsTotal": 2,
  "data": [
    {
      "id": 88120,
      "name": "Dana Whitfield",
      "email": "dana@northwind.com",
      "linkedin_url": "https://www.linkedin.com/in/example-dana",
      "company": "Northwind Logistics",
      "job_title": "Head of Growth"
    },
    {
      "id": 88121,
      "name": "Luis Ortega",
      "email": "luis@globex.co",
      "linkedin_url": "https://www.linkedin.com/in/example-luis",
      "company": "Globex",
      "job_title": "VP Marketing"
    }
  ]
}

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.