> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tellscope.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Account

> Retrieve a single account by ID

## Query

```graphql theme={null}
query {
  accountItem(
    apiKey: String!
    id: String!
  ): AccountItem
}
```

## Parameters

<ParamField query="apiKey" type="string" required>
  Your Tellscope API key
</ParamField>

<ParamField query="id" type="string" required>
  The unique identifier of the account
</ParamField>

## Response

Returns a single `AccountItem` or `null` if not found.

<ResponseField name="id" type="string">Unique identifier</ResponseField>
<ResponseField name="name" type="string">Account/company name</ResponseField>
<ResponseField name="domain" type="string">Primary domain</ResponseField>
<ResponseField name="description" type="string">Account description</ResponseField>
<ResponseField name="website" type="string">Full website URL</ResponseField>
<ResponseField name="score" type="float">Health score (0-1)</ResponseField>
<ResponseField name="churnRisk" type="float">Churn risk score (0-1)</ResponseField>
<ResponseField name="tags" type="array">Tags assigned to this account</ResponseField>
<ResponseField name="createdAt" type="datetime">When the account was added</ResponseField>

## Example

<CodeGroup>
  ```graphql Query theme={null}
  query {
    accountItem(
      apiKey: "tellscp_sk_YOUR_API_KEY"
      id: "acc_xyz789"
    ) {
      id
      name
      domain
      description
      website
      score
      churnRisk
      tags
      createdAt
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "accountItem": {
        "id": "acc_xyz789",
        "name": "TechStart Inc",
        "domain": "techstart.io",
        "description": "Enterprise software company specializing in workflow automation",
        "website": "https://techstart.io",
        "score": 0.85,
        "churnRisk": 0.12,
        "tags": ["enterprise", "annual", "champion"],
        "createdAt": "2023-03-20T08:00:00Z"
      }
    }
  }
  ```
</CodeGroup>

## Understanding the Response

### Health Score

The `score` field represents the overall health of the account based on:

* Feedback sentiment trends
* Engagement frequency
* Support ticket patterns
* Feature adoption

| Score Range | Status          |
| ----------- | --------------- |
| 0.8 - 1.0   | Healthy         |
| 0.5 - 0.79  | Needs attention |
| 0.0 - 0.49  | At risk         |

### Churn Risk

The `churnRisk` field indicates the likelihood of the account churning:

| Risk Range | Level  |
| ---------- | ------ |
| 0.0 - 0.2  | Low    |
| 0.2 - 0.5  | Medium |
| 0.5 - 1.0  | High   |

## Error Responses

### Account Not Found

```json theme={null}
{
  "data": {
    "accountItem": null
  }
}
```

### Not Authorized

If trying to access an account from another organization:

```json theme={null}
{
  "errors": [
    {
      "message": "Not authorized to access this account",
      "extensions": {
        "code": "FORBIDDEN"
      }
    }
  ]
}
```