Get account

One account with its contacts, open jobs and open requests.

GET https://cotlet.dev/api/v1/taxdome/accounts/{account_id}

read

Returns one account with its contacts, the jobs that are in progress and the client requests still open. Use it before writing to a client so your agent sees what they were already asked.

Parameters

Parameters: get_account
NameTypeDescription
account_id string required string Account ID from list_accounts.

Request

cURL
curl https://cotlet.dev/api/v1/taxdome/accounts/account_8c41d2 \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("taxdome", "get_account", {"account_id":"account_8c41d2"})
Node.js
const result = await cotlet.call('taxdome', 'get_account', {"account_id":"account_8c41d2"});
CLI
cotlet call taxdome get_account --data '{"account_id":"account_8c41d2"}'

Example response

JSON

{
  "account_id": "acc_4f21",
  "name": "Harbor Dental LLC",
  "type": "company",
  "contacts": [
    {
      "name": "Dana Reyes",
      "email": "dana@harbordental.example",
      "portal_login": true
    }
  ],
  "open_jobs": [
    {
      "job_id": "job_3081",
      "name": "Annual Filing 2026",
      "stage": "Collect docs"
    }
  ],
  "open_requests": [
    {
      "request_id": "req_912",
      "title": "2026 tax documents"
    }
  ]
}

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.