Whoami

Try in Playground

Get the authenticated API account for this session.

Try in Playground

GET/v1/whoami

Headers

Get your API key

x-api-keystringheader

API key (`sfk_...`)

Response fields

15

Endpoint-specific response payload.

Authenticated user associated with the provided API key.

datauserid

string

Internal Social Fetch user identifier.

datausername

stringnullable

Display name for the authenticated user, when available.

datauseremail

stringnullable

Email address for the authenticated user, when available.

Workspace the API key acts in.

dataworkspaceid

string

Identifier of the workspace the API key acts in.

dataworkspacename

string

Display name of the workspace.

dataworkspacerole

string

Role the API key's creator holds in the workspace (for example owner, admin or member).

dataworkspaceisPersonal

boolean

True when the workspace is the caller's own personal workspace rather than a shared one.

Metadata describing the request and billing outcome.

metarequestId

string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged

integer

Credits charged for this request.

≥ 0

metaversion

string

Public API version that served the response.

one of: v1

metacached

booleanoptional

True when served from shared response cache. Credits still apply (full endpoint price); Age header may be present.

Code example

curl "https://api.socialfetch.dev/v1/whoami" \
  -H "x-api-key: YOUR_API_KEY"

Responses

OK

Ask

Route a natural-language social-data question to the right lookup when you do not yet know the typed tool — prefer typed tools once the operation is known.

Balance

Get remaining credit balance before running large batches of metered tools.