List contacts

Customers and suppliers with ID, name, organisation number, email and customer or supplier number.

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

read

Lists the contacts of the company. Search by name or organisation number to check whether a contact exists before creating one, and filter by role to get only customers or only suppliers. Use contact_id as customer_id in create_invoice and as supplier_id in create_purchase. Pages hold up to 100 contacts; pass next_cursor back as cursor for the next page.

Parameters

Parameters: list_contacts
NameTypeDescription
search string string Contact name or organisation number.
role enum enum all, customer or supplier. Default: all.
limit integer integer 1 to 100. Default: 25.
cursor string string Next page cursor from the previous call.

Request

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

Example response

JSON

{
  "contacts": [
    {
      "contact_id": 4021188,
      "name": "Nordlys Design AS",
      "organisation_number": "912345678",
      "email": "okonomi@nordlys.example",
      "customer_number": 10003,
      "supplier_number": null
    }
  ],
  "next_cursor": null
}

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.