Get X account profile
Read the live profile for the connected X account owned by one Managed User. The connection must preserve its X app identity and include users.read plus offline.access. The x_credits_billing_v1 flag controls customer accounting, not endpoint availability.
Authorization
AuthorizationBearer <token>In header
Workspace API key.
Idempotency-KeystringRequired header
Caller-owned key for this logical read. Reuse it only for an exact retry.
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
Accounting mode and, when enabled, the estimate, reservation, charge, and release for this read.
meta.credits.accounting_enabledboolean
True only for UniPost-managed X accounts while x_credits_billing_v1 is enabled.
meta.credits.bypass_reasonstring
feature_disabled while billing is off, or customer_x_app for workspace-owned X credentials.
meta.replayedboolean
Present and true when this is the stored result of an exact idempotent retry. Absence means false.
request_idstring
Request identifier for logs and support.
400
error.codestring
Stable uppercase machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
error.is_retriableboolean
Whether the same logical read may be retried.
request_idstring
Request identifier for support.
401
error.codestring
Stable uppercase machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
error.is_retriableboolean
Whether the same logical read may be retried.
request_idstring
Request identifier for support.
403
error.codestring
Stable uppercase machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
error.is_retriableboolean
Whether the same logical read may be retried.
request_idstring
Request identifier for support.
404
error.codestring
Stable uppercase machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
error.is_retriableboolean
Whether the same logical read may be retried.
request_idstring
Request identifier for support.
409
error.codestring
Stable uppercase machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
error.is_retriableboolean
Whether the same logical read may be retried.
request_idstring
Request identifier for support.
422
error.codestring
Stable uppercase machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
error.is_retriableboolean
Whether the same logical read may be retried.
request_idstring
Request identifier for support.
429
error.codestring
Stable uppercase machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
error.is_retriableboolean
Whether the same logical read may be retried.
request_idstring
Request identifier for support.
502
error.codestring
Stable uppercase machine-readable error code.
error.messagestring
Human-readable error message.
error.detailsobject
Retry or Credits details when available.
error.is_retriableboolean
Whether the same logical read may be retried.
request_idstring
Request identifier for support.
Stable errors and exact retries
Handle VALIDATION_ERROR, IDEMPOTENCY_KEY_REQUIRED, ACCOUNT_NOT_FOUND, WRONG_PLATFORM, ACCOUNT_ACCESS_DENIED, ACCOUNT_REAUTHORIZATION_REQUIRED, IDEMPOTENCY_CONFLICT, READ_IN_PROGRESS, READ_SETTLEMENT_PENDING, RATE_LIMITED, and X_UPSTREAM_ERROR by their stable error.code. For a retriable response, inspect is_retriable and the HTTP Retry-After header, then repeat the exact request with the same Idempotency-Key. Never generate a replacement key for an exact retry.
Customer Credits accounting is currently disabled. The response still reports accounting_enabled=false and bypass_reason=feature_disabled. A workspace-owned X app instead reports bypass_reason=customer_x_app.