Skip to navigation

Retrieve the account's P2P profile

The account’s own P2P profile, advertiser status and reputation. An account that never set a username returns username: null and advertiserStatus: none.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

accountIdstringRequired
Account identifier.

Headers

X-Tenant-IdstringRequired
Tenant context used for authorization and routing.
X-Request-TimestampstringRequired

Unix seconds. Required on the signed host; tolerance is 300s either way (403 request_timestamp_skew).

X-Content-SHA256stringRequired

Lowercase hex SHA-256 of the body. An empty body hashes the empty string, so the header is always present. Mismatch returns 400 body_hash_mismatch.

X-Request-SignaturestringRequired

Detached JWS (<protected>..<signature>, ES256 or PS256) over METHOD\nPATH?QUERY\nTIMESTAMP\nIDEMPOTENCY_KEY_OR_EMPTY\nX_CONTENT_SHA256.

Response

Profile
accountIdstringOptional
Account.
usernamestring or nullOptional
Username.
usernameChangedAtdatetime or nullOptional

Last username change. null while the username is the one the profile was created with.

usernameNextChangeAtdatetime or nullOptional

From when a new username is accepted (90 days after the last change). null when it can change now.

advertiserStatusenumOptional
Advertiser status.
Allowed values:
advertiserNotestringOptional
CorpX note on refusal or suspension.
levelstring or nullOptional
Advertiser level.
orderCapstring or nullOptional

Per-order cap for this advertiser.

feeBpsintegerOptional

Fee, in basis points of the order amount, charged to this account on the orders of its own ads: the seller receives the amount minus the fee on a sell ad, the buyer pays the amount plus the fee on a buy ad. Comes from the level; without a level, the lowest level’s fee applies. 0 when the market has no levels.

memberSincedatetime or nullOptional
Profile creation.
reputationobjectOptional

Trading statistics. Values below the tenant’s minimum number of orders are null.

contactobjectOptional

E-mail and phone confirmed on the P2P profile, masked. The signer document is never sent by the client: for an individual it is the account document, for a company it is the holder who confirmed the contact.

Errors

403
Forbidden Error
404
Not Found Error