Get X account profile
Reads the live profile for one connected X account using users.read and offline.access. The account is confined to the supplied Managed User; arbitrary X user lookup is not supported. The x_credits_billing_v1 flag controls customer accounting, not endpoint availability.
Authorization
AuthorizationBearer <token>In header
Workspace API key.
Idempotency-KeystringRequired header
Unique key for this logical read. Reuse it only when retrying the exact same request.
Path Params
account_idstring
Connected X account ID.
Query Params
external_user_idstringRequired
Managed User that owns the connected account. It must exactly match the account record.
Response Body
200
data.account_idstring
UniPost connected-account ID.
data.platformstring
Always "twitter".
data.external_account_idstring
X user ID read from the authorized account record.
data.usernamestring
Current X username.
data.display_namestring
Current X display name.
data.descriptionstring
Current profile biography.
data.profile_image_urlstring
Current profile image URL.
data.locationstring
Optional public location.
data.website_urlstring
Optional public website URL.
data.account_created_atstring
RFC 3339 account creation time.
data.verifiedboolean
Whether X currently reports the account as verified.
data.public_metricsobject
Followers, following, posts, and listed counts.
data.retrieved_atstring
RFC 3339 time when UniPost completed the upstream read.
meta.creditsobject
Estimate, reservation, charge, release, operation, catalog version, and accounting mode for this read.
meta.credits.accounting_enabledboolean
True only for UniPost-managed X accounts while x_credits_billing_v1 is enabled.
meta.replayedboolean
True when this is the stored result of an idempotent retry.
400
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
request_idstring
Request identifier for support.
401
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
request_idstring
Request identifier for support.
402
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
request_idstring
Request identifier for support.
403
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
request_idstring
Request identifier for support.
404
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
request_idstring
Request identifier for support.
409
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
request_idstring
Request identifier for support.
422
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
request_idstring
Request identifier for support.
429
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
request_idstring
Request identifier for support.
502
error.codestring
Stable machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
request_idstring
Request identifier for support.