Skip to main content

​
Query

query {
  accountItems(
    apiKey: String!
    skip: Int
    take: Int
    search: String
  ): AccountItemList!
}

​
Parameters

​
apiKey
string
required
Your Tellscope API key
​
skip
integer
default:"0"
Number of items to skip for pagination
​
take
integer
default:"50"
Number of items to return (max 100)
​
search
string
Search term to filter accounts by name or domain

​
Response

​
items
array
Array of account items
​
total
integer
Total count of matching accounts

​
Example

query {
  accountItems(
    apiKey: "tellscp_sk_YOUR_API_KEY"
    take: 10
    search: "tech"
  ) {
    items {
      id
      name
      domain
      score
      churnRisk
      tags
    }
    total
  }
}

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 } }"
  }'

​
Understanding Scores

FieldDescriptionRange
scoreOverall health score0.0 (poor) - 1.0 (excellent)
churnRiskLikelihood of churning0.0 (low risk) - 1.0 (high risk)
Accounts are read-only via the public API. To create or update accounts, use the Tellscope dashboard or integrations.