List people
Returns People, most recently updated first. A Person who belongs to several Companies appears once for each Company. Filter by Company, email or your own id.
Archived records are left out unless you send includeArchived=true. A record is archived when the Person left that Company or its source removed them. Each record has archivedAt, which is null for a live one.
Scope: read:contacts
Authorizations
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
Max rows to return. Default 50, max 100.
1 <= x <= 100Rows to skip (pagination).
x >= 0Only People at this Company.
Exact match.
Your own stable id for the Person (for example a Segment userId). Exact match.
Set to true to include archived records. GainTrace archives a record instead of deleting it when its source removes it, or when a Person leaves a Company. Lists leave archived records out by default. Any value other than true or false returns 422.