Skip to main content
GET
Get one contact

Authorizations

Authorization
string
header
required

A SuperX API key ("sxk_..."), created in the SuperX app under Account > API / MCP / CLI. Keys are server-side secrets.

Path Parameters

id
string
required

The person's numeric X user id (from GET /v1/contacts, list members, or signal leads).

Query Parameters

account_id
string

Account to act on, from GET /v1/accounts. Defaults to your main account. An id outside your accounts returns 404 account_not_found.

refresh
boolean
default:false

Refresh the profile from X when the stored copy is stale. Costs one enrichment unit. The refresh=true enrichment unit is charged only after the contact gate passes, so an id outside your contacts does not spend one.

Response

The contact.

data
object

One person's stored profile plus the lists you created that they are in.