Skip to main content
GET
/
users
/
by-username
/
{username}
Get user by Twitter username
curl --request GET \
  --url http://localhost:4000/v1/users/by-username/{username} \
  --header 'Authorization: <api-key>'
{
  "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "username": "john_doe",
  "id_x": 12345678,
  "created_at": "2024-05-12T13:47:00.000Z",
  "updated_at": "2024-05-13T10:00:00.000Z",
  "address": "0x123abc456def789012345678901234567890abcd",
  "privy_id": "privy-did:123abc456def789012345678901234567890abcd",
  "privy_address": "0x456def789012345678901234567890abcdef123",
  "thirdweb_address": "0x789abc012345678901234567890abcdef123456"
}

Authorizations

​
Authorization
string
header
required

Use this format: ApiKey <your_api_key>

Path Parameters

​
username
string
required

Twitter username (without @)

Example:

"francocarballa"

Response

User retrieved successfully

​
id
string
required

Unique identifier for the user (UUID).

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

​
username
string
required

Unique username of the user.

Example:

"john_doe"

​
id_x
object
required

Unique X / Ttwitter ID of the user.

Example:

12345678

​
created_at
string<date-time>
required

Timestamp of user creation.

Example:

"2024-05-12T13:47:00.000Z"

​
updated_at
object
required

Timestamp of last update (if any).

Example:

"2024-05-13T10:00:00.000Z"

​
address
string
required

Ethereum wallet address of the user.

Example:

"0x123abc456def789012345678901234567890abcd"

​
privy_id
object
required

Privy unique identifier.

Example:

"privy-did:123abc456def789012345678901234567890abcd"

​
privy_address
object
required

Privy wallet address.

Example:

"0x456def789012345678901234567890abcdef123"

​
thirdweb_address
object
required

Original ThirdWeb wallet address (backup).

Example:

"0x789abc012345678901234567890abcdef123456"