Reference

Me

The person behind an access token, and the state of their connection to your app.

Get the signed-in user

GET/v1/me

User access tokenprofile

Returns the identity behind the access token plus the current state of the connection: the scopes the user granted and the CV they chose to share. The email address is present only when the user granted the email scope, and the photo only when they allowed it.

Response

These fields sit inside data.

FieldTypeDescription
idalwaysstring

The Tabbio user id. Stable forever.

namealwaysstring

The name the user shows on their profile.

usernamealwaysstring or null

Their Tabbio handle, when they set one.

headlinealwaysstring or null

The one-line role under their name.

localealwaysstring or null

The language the user picked in Tabbio, or null when they never did.

avatarUrlalwaysstring or null

Profile photo. Null when the user chose not to share it.

profileUrlalwaysstring or null

Their public Tabbio profile, or null when that page would not resolve.

emailstring

Present only when the user granted the email scope.

connectionalwaysobject

The current state of this user’s consent to your app.

idalwaysstring

The connection between this user and your app.

scopesalwaysstring[]

What the user actually granted. May be fewer than you asked.

cvalwaysobject or null

The CV they share, or null without the cv:read scope.

idalwaysstring

"master" for the profile-backed main CV, otherwise the CV id.

titlealwaysstring

What the user calls this CV.

updatedAtalwaysstring

When the CV last changed.

createdAtalwaysstring

When the user first connected your app.

Status codes

  • 200

    The signed-in user.

  • 401

    The access token is missing, expired, or revoked.

  • 403

    The user did not grant the profile scope.

Request
curl https://server.tabbio.com/v1/me \
  -H "Authorization: Bearer $TABBIO_ACCESS_TOKEN"
Response 200
{
  "data": {
    "id": "usr_2f8a91",
    "name": "Sara Ahmed",
    "username": "sara",
    "headline": "Senior product designer",
    "locale": "en",
    "avatarUrl": "https://cdn.tabbio.com/avatars/sara.jpg",
    "profileUrl": "https://sara.tabbio.com",
    "email": "sara@example.com",
    "connection": {
      "id": "con_9d21f4",
      "scopes": [
        "profile",
        "email",
        "cv:read",
        "cv:contact"
      ],
      "cv": {
        "id": "master",
        "title": "Main CV",
        "updatedAt": "2026-08-30T09:12:04.000Z"
      },
      "createdAt": "2026-08-30T09:10:41.000Z"
    }
  },
  "error": null,
  "meta": null
}

Base URL https://server.tabbio.com. Every response outside the token endpoint uses the { data, error, meta } envelope.