List accounts

Client accounts, individuals and companies, with their contacts.

GET https://cotlet.dev/api/v1/taxdome/accounts

read

Lists client accounts, each an Individual or a Company, with the contacts linked to it. Search by name or email and page with the cursor. Visibility follows the rights of the login you connected: a team member sees the accounts they are assigned to or may view.

Parameters

Parameters: list_accounts
NameTypeDescription
query string string Search by account name or contact email.
type string string 'individual' or 'company'.
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/taxdome/accounts \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("taxdome", "list_accounts")
Node.js
const result = await cotlet.call('taxdome', 'list_accounts');
CLI
cotlet call taxdome list_accounts

Example response

JSON

{
  "accounts": [
    {
      "account_id": "acc_4f21",
      "name": "Harbor Dental LLC",
      "type": "company",
      "contacts": [
        {
          "name": "Dana Reyes",
          "email": "dana@harbordental.example"
        }
      ]
    },
    {
      "account_id": "acc_7c09",
      "name": "Nguyen Family",
      "type": "individual",
      "contacts": [
        {
          "name": "Linh Nguyen",
          "email": "linh@nguyen.example"
        }
      ]
    }
  ],
  "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.