Skip to main content
GET
/
companies
List companies
curl --request GET \
  --url https://app.gaintrace.com/api/v1/companies \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "externalId": "<string>",
      "name": "<string>",
      "domain": "<string>",
      "industry": "<string>",
      "employeeCount": 123,
      "plan": "<string>",
      "segment": "<string>",
      "region": "<string>",
      "location": "<string>",
      "lifecycleStage": "<string>",
      "ownerEmail": "<string>",
      "arr": 123,
      "mrr": 123,
      "currency": "<string>",
      "contractStartDate": "2023-11-07T05:31:56Z",
      "contractEndDate": "2023-11-07T05:31:56Z",
      "autoRenew": true,
      "healthScore": 123,
      "contactCount": 123,
      "dealCount": 123,
      "isPhantom": true,
      "lastActivityAt": "2023-11-07T05:31:56Z",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "meta": {
    "limit": 123,
    "offset": 123,
    "count": 123
  }
}

Authorizations

Authorization
string
header
required

Bearer API key. Secret server keys start with gt_live_; client-safe browser keys start with gt_pub_ (write-only, origin-pinned). Create and scope keys in Settings → API Keys.

Query Parameters

limit
integer
default:50

Max rows to return. Default 50, max 100.

Required range: 1 <= x <= 100
offset
integer
default:0

Rows to skip (pagination).

Required range: x >= 0
healthStatus
enum<string>
Available options:
healthy,
at_risk,
churning
segment
string
plan
string

Case-insensitive match on name or domain.

Response

A page of companies.

data
object[]
meta
object
Last modified on July 6, 2026