---
title: "Get account details"
method: GET
path: "/v1/accounts/{accountId}"
tags: ["Accounts and users"]
---

# Get account details

`GET /v1/accounts/{accountId}`

## Request

- Base URL: `https://yourbaseurl.talon.one`
- URL: `https://yourbaseurl.talon.one/v1/accounts/{accountId}`
- Auth: one of:
  - API key in header `Authorization`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/talon/apis/management-api/docs/v1/accounts/:accountId/get.ts> (a function with typed inputs; its response is checked against the schema)

> [!note] Management API endpoints are **not** meant to be used in real-time integrations that directly serve your end users. Rate limit: 3 requests per second.

Return the details of your companies Talon.One account.

## Path parameters

- `accountId` integer, required

## Response `200`

OK

- Account
  - `id` integer, required: The internal ID of this entity.
  - `created` string, date-time, required: The time this entity was created.
  - `modified` string, date-time, required: The time this entity was last modified.
  - `companyName` string, required
  - `domainName` string, required: Subdomain Name for yourcompany.talon.one.
  - `state` 'active' | 'deactivated', required: State of the account (active, deactivated).
  - `billingEmail` string, email, required: The billing email address associated with your company account.
  - `planName` string: The name of your booked plan.
  - `planExpires` string, date-time: The point in time at which your current plan expires.
  - `applicationLimit` integer: The maximum number of Applications covered by your plan.
  - `userLimit` integer: The maximum number of Campaign Manager Users covered by your plan.
  - `campaignLimit` integer: The maximum number of Campaigns covered by your plan.
  - `apiLimit` integer: The maximum number of Integration API calls covered by your plan per billing period.
  - `applicationCount` integer, required: The current number of Applications in your account.
  - `userCount` integer, required: The current number of Campaign Manager Users in your account.
  - `campaignsActiveCount` integer, required: The current number of active Campaigns in your account.
  - `campaignsInactiveCount` integer, required: The current number of inactive Campaigns in your account.
  - `attributes` object: Arbitrary properties associated with this campaign.

---

[API](https://skmtc.dev/talon/apis/management-api.md) - [All operations](https://skmtc.dev/talon/apis/management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/talon/apis/management-api/revisions/7ef1b9504c3a?raw)