Get Started
Essentials
New Features
Declarations
curl --request GET \
--url https://api.b-bot.space/api/v1/get_user \
--header 'bbot-api-key: <api-key>'[
{
"user": {
"user_id": "google-oauth2|123456789012345678901",
"email": "[email protected]",
"given_name": "John",
"email_verified": true,
"updated_at": "2024-07-28T18:16:33.568Z",
"identities": [
{
"access_token": "ya29.a0AXyoCgtJQY6FVBiPDTJq...",
"expires_in": 3599,
"connection": "google-oauth2",
"user_id": "123456789012345678901",
"provider": "google-oauth2",
"isSocial": true
}
],
"created_at": "2024-03-18T17:08:05.432Z",
"user_metadata": {
"message_me": false,
"newsletter": false,
"api_keys": [
"bbot_abcdefghij1234567890"
],
"updates": false,
"features": true,
"apps": {},
"tokens": 500,
"follows_me": true,
"mentions_me": true
},
"name": "John Doe",
"nickname": "john.doe",
"picture": "https://lh3.googleusercontent.com/a/ACg8ocL54DkmYmCmnGDiKfGJ2zv...",
"family_name": "Doe",
"last_login": "2024-07-28T18:16:16.163Z",
"last_ip": "192.168.1.1",
"logins_count": 125,
"app_metadata": {}
}
}
]Get User
This endpoint retrieves detailed information about the authenticated user. It provides various details including the user’s email, name, associated identities, metadata, and more.
curl --request GET \
--url https://api.b-bot.space/api/v1/get_user \
--header 'bbot-api-key: <api-key>'[
{
"user": {
"user_id": "google-oauth2|123456789012345678901",
"email": "[email protected]",
"given_name": "John",
"email_verified": true,
"updated_at": "2024-07-28T18:16:33.568Z",
"identities": [
{
"access_token": "ya29.a0AXyoCgtJQY6FVBiPDTJq...",
"expires_in": 3599,
"connection": "google-oauth2",
"user_id": "123456789012345678901",
"provider": "google-oauth2",
"isSocial": true
}
],
"created_at": "2024-03-18T17:08:05.432Z",
"user_metadata": {
"message_me": false,
"newsletter": false,
"api_keys": [
"bbot_abcdefghij1234567890"
],
"updates": false,
"features": true,
"apps": {},
"tokens": 500,
"follows_me": true,
"mentions_me": true
},
"name": "John Doe",
"nickname": "john.doe",
"picture": "https://lh3.googleusercontent.com/a/ACg8ocL54DkmYmCmnGDiKfGJ2zv...",
"family_name": "Doe",
"last_login": "2024-07-28T18:16:16.163Z",
"last_ip": "192.168.1.1",
"logins_count": 125,
"app_metadata": {}
}
}
]identities array contains details about the user’s authentication
identities, including access tokens and their expiration.user_metadata and app_metadata objects can include various custom data
associated with the user.Authorizations
API key for authentication
Response
Get User response
The authenticated user's details.
Show child attributes
Show child attributes
Unique identifier of the user.
"google-oauth2|123456789012345678901"
User's email address.
User's given (first) name.
"John"
Whether the user's email is verified.
true
Timestamp when the user was last updated.
"2024-07-28T18:16:33.568Z"
List of identity objects associated with the user.
Show child attributes
Show child attributes
Access token for the identity.
"ya29.a0AXyoCgtJQY6FVBiPDTJq..."
Expiration time of the access token in seconds.
3599
Connection type.
"google-oauth2"
User ID within the connection.
"123456789012345678901"
Provider of the connection.
"google-oauth2"
Whether the connection is social.
true
Timestamp when the user was created.
"2024-03-18T17:08:05.432Z"
Custom metadata associated with the user.
Show child attributes
Show child attributes
User preference for receiving messages.
false
User subscription status for newsletters.
false
List of API keys associated with the user.
User preference for receiving updates.
false
User preference for receiving feature updates.
true
Custom app data associated with the user.
{}Number of tokens the user has.
500
Whether the user follows me.
true
Whether the user mentions me.
true
Full name of the user.
"John Doe"
User's nickname.
"john.doe"
URL of the user's profile picture.
"https://lh3.googleusercontent.com/a/ACg8ocL54DkmYmCmnGDiKfGJ2zv..."
User's family (last) name.
"Doe"
Timestamp of the user's last login.
"2024-07-28T18:16:16.163Z"
IP address used during the user's last login.
"192.168.1.1"
Total number of logins by the user.
125
Additional metadata associated with the user's apps.
{}