OAuth

Get authenticated user info (OIDC UserInfo)

Standard OIDC UserInfo endpoint. Returns claims about the authenticated user based on the granted scopes.

Scopes: profile for name, email for email, wallet for wallet_address, and referral for referral_code and referral_link. A non-OAuth user token sees every field, since it is the user's own data.

referral is separate from profile deliberately: a referral code is something the holder is asked to spread, so an app has to request it by name and the consent screen names it.

get/v1/oauth/userinfo

Request

  • Base URL: https://api.1claw.co
  • URL: https://api.1claw.co/v1/oauth/userinfo
  • Auth: HTTP bearer

Response

User info

substring uuid required
emailstring email required
namestring nullable
wallet_addressstring nullable
referral_codestring nullable

The user's referral code, returned only under the referral scope. Minted on first read, so a user signing in to a partner site for the first time still gets one.

referral_linkstring nullable

The same code as a shareable URL, built for the brand the request arrived on — returned so a host app never has to assemble it and pick the wrong domain.

Example response

{
  "referral_code": "7f3a9c2b",
  "referral_link": "https://1claw.co/?ref=7f3a9c2b"
}

Changes

No recorded changes to this operation across all 1 revision of this API.