> ## 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.

# List Accounts

> Retrieve a paginated list of accounts

## Query

```graphql theme={null}
query {
  accountItems(
    apiKey: String!
    skip: Int
    take: Int
    search: String
  ): AccountItemList!
}
```

## Parameters

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

<ParamField query="skip" type="integer" default="0">
  Number of items to skip for pagination
</ParamField>

<ParamField query="take" type="integer" default="50">
  Number of items to return (max 100)
</ParamField>

<ParamField query="search" type="string">
  Search term to filter accounts by name or domain
</ParamField>

## Response

<ResponseField name="items" type="array">
  Array of account items

  <Expandable title="AccountItem">
    <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">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">Array of tags</ResponseField>
    <ResponseField name="createdAt" type="datetime">Record creation date</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="total" type="integer">
  Total count of matching accounts
</ResponseField>

## Example

<CodeGroup>
  ```graphql Query theme={null}
  query {
    accountItems(
      apiKey: "tellscp_sk_YOUR_API_KEY"
      take: 10
      search: "tech"
    ) {
      items {
        id
        name
        domain
        score
        churnRisk
        tags
      }
      total
    }
  }
  ```

  ```json Response theme={null}
  {
    "data": {
      "accountItems": {
        "items": [
          {
            "id": "acc_xyz789",
            "name": "TechStart Inc",
            "domain": "techstart.io",
            "score": 0.85,
            "churnRisk": 0.12,
            "tags": ["enterprise", "annual"]
          },
          {
            "id": "acc_abc456",
            "name": "DataTech Solutions",
            "domain": "datatech.com",
            "score": 0.72,
            "churnRisk": 0.28,
            "tags": ["mid-market", "monthly"]
          }
        ],
        "total": 2
      }
    }
  }
  ```
</CodeGroup>

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.tellscope.io/graphql \
    -H "Content-Type: application/json" \
    -d '{
      "query": "query { accountItems(apiKey: \"tellscp_sk_YOUR_API_KEY\", take: 10) { items { id name domain score churnRisk } total } }"
    }'
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.tellscope.io/graphql', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      query: `
        query {
          accountItems(
            apiKey: "${process.env.TELLSCOPE_API_KEY}"
            take: 10
          ) {
            items {
              id
              name
              domain
              score
              churnRisk
            }
            total
          }
        }
      `
    })
  });
  ```
</CodeGroup>

## Understanding Scores

| Field       | Description            | Range                            |
| ----------- | ---------------------- | -------------------------------- |
| `score`     | Overall health score   | 0.0 (poor) - 1.0 (excellent)     |
| `churnRisk` | Likelihood of churning | 0.0 (low risk) - 1.0 (high risk) |

<Note>
  Accounts are read-only via the public API. To create or update accounts, use the Tellscope dashboard or integrations.
</Note>