Skip to main content
GET
Get one account

Authorizations

Authorization
string
header
required

A workspace API key, created in workspace settings and sent as Authorization: Bearer op_live_…. Session cookies are not accepted. Scopes: signals:read, accounts:read, listeners:read, listeners:analyse, pipeline:read, pipeline:write, collections:write, export:read.

Path Parameters

key
string
required

The namespaced account key, e.g. d:acme.com for a domain. Percent-encode it: the : is part of the key, not a separator. An aliasKeys entry resolves here too, so a key from before a merge still works.

Response

The account and its context, assembled server-side. Six reads in one request rather than six requests: every one of them is keyed on the account the first read already found, so a client doing this itself would waterfall them.

account
object
required

One company, with everything the workspace has found about it rolled up. Workspace-scoped rather than listener-scoped: a company three listeners have touched is one row, not three.

signals
object
required

One page of this account's signals, newest or strongest first depending on the endpoint.

notes
object[]
required

The 20 most recent notes written about this account. Not paginated.

competitor
object | null
required

The watchlist row, when this company is also a tracked competitor. null is the normal case, not a failure.

company
object | null
required

The hiring roll-up, when postings from this company have been found. null otherwise, and also null if that lookup failed — one missing join must not take the whole response down.