curl --request GET \
  --url https://app.gaintrace.com/api/v1/surveys/coverage \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://app.gaintrace.com/api/v1/surveys/coverage', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://app.gaintrace.com/api/v1/surveys/coverage"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

{
  "data": {
    "windowDays": 365,
    "companies": 42,
    "companiesHeard": 17,
    "companiesWithDecisionMaker": 9,
    "reportingCurrency": "USD",
    "arrTotal": 48200000,
    "arrHeard": 29150000,
    "unconvertedCurrencies": [],
    "silentRenewals": {
      "count": 1,
      "companies": [
        {
          "id": "9b2f6c1e-5d4a-4c3b-8a1f-2e7d9c0b6a55",
          "name": "Northwind Traders",
          "renewalDate": "2026-11-20T00:00:00.000Z",
          "arr": 6400000,
          "currency": "USD"
        }
      ]
    },
    "companiesInferredOnly": null
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Missing Authorization header",
    "doc_url": "https://docs.gaintrace.com/errors#unauthorized"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "Insufficient scope: write:companies required",
    "doc_url": "https://docs.gaintrace.com/errors#forbidden"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Can't accept more than 60 requests a minute from one API key. Retry in 23 seconds.",
    "doc_url": "https://docs.gaintrace.com/errors#rate_limit_exceeded"
  }
}

{
  "error": {
    "code": "internal_server_error",
    "message": "Something went wrong. Try again in a moment.",
    "doc_url": "https://docs.gaintrace.com/errors#internal_server_error"
  }
}

{
  "error": {
    "code": "service_unavailable",
    "message": "We had trouble reaching the database. Try again in a moment.",
    "doc_url": "https://docs.gaintrace.com/errors#service_unavailable"
  }
}

{
  "error": {
    "code": "gateway_timeout",
    "message": "The request timed out. Try again in a moment.",
    "doc_url": "https://docs.gaintrace.com/errors#gateway_timeout"
  }
}