Sign in

v46

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-211591,0051.4 MB
Users

Lookup User by Twitter Subject

Looks up a user by their Twitter subject.

post/v1/users/twitter/subject

Headers

privy-app-idstring required

ID of your Privy app.

Request body

subjectstring required

Response

Object with user data.

created_atnumber required

Unix timestamp of when the user was created in seconds.

custom_metadataCustomMetadata

Custom metadata associated with the user.

has_accepted_termsboolean required

Indicates if the user has accepted the terms of service.

idstring required
is_guestboolean required

Indicates if the user is a guest account user.

Example response

{
  "created_at": 1731974895,
  "has_accepted_terms": true,
  "id": "did:privy:cm3np4u9j001rc8b73seqmqqk",
  "is_guest": false,
  "linked_accounts": [
    {
      "address": "tom.bombadill@privy.io",
      "first_verified_at": 1674788927,
      "latest_verified_at": 1674788927,
      "type": "email",
      "verified_at": 1674788927
    },
    {
      "bio": "engineering at /privy. building pixelpool.xyz, the first Farcaster video client. nyc. 👨‍💻🍎🏳️‍🌈  nf.td/payton",
      "display_name": "payton ↑",
      "fid": 4423,
      "first_verified_at": 1740678402,
      "latest_verified_at": 1741194370,
      "owner_address": "0xE6bFb4137F3A8C069F98cc775f324A84FE45FdFF",
      "profile_picture": "https://supercast.mypinata.cloud/ipfs/QmNexfCxdnFzWdJqKVgrjd27UGLMexNaw5FXu1XKR3cQF7?filename=IMG_2799.png",
      "profile_picture_url": "https://supercast.mypinata.cloud/ipfs/QmNexfCxdnFzWdJqKVgrjd27UGLMexNaw5FXu1XKR3cQF7?filename=IMG_2799.png",
      "type": "farcaster",
      "username": "payton",
      "verified_at": 1740678402
    },
    {
      "authenticator_name": "1Password",
      "created_with_browser": "Chrome",
      "created_with_device": "Macintosh",
      "created_with_os": "Mac OS",
      "credential_id": "Il5vP-3Tm3hNmDVBmDlREgXzIOJnZEaiVnT-XMliXe-BufP9GL1-d3qhozk9IkZwQ_",
      "enrolled_in_mfa": true,
      "first_verified_at": 1741194420,
      "latest_verified_at": 1741194420,
      "public_key": "pQECAyYgASFYIKdGwx5XxZ/7CJJzT8d5L6jyLNQdTH7X+rSZdPJ9Ux/QIlggRm4OcJ8F3aB5zYz3T9LxLdDfGpWvYkHgS4A8tPz9CqE=",
      "type": "passkey",
      "verified_at": 1741194420
    }
  ],
  "mfa_methods": [
    {
      "type": "passkey",
      "verified_at": 1741194420
    }
  ]
}