Get Auth Token Metadata | Vercel REST API

APIs & SDKs

Get Auth Token Metadata

GEThttps://api.vercel.com/v5/user/tokens/{tokenId}

Retrieve metadata about an authentication token belonging to the currently authenticated User.

https://api.vercel.com/v5/user/tokens/{tokenId}

const response = await fetch('https://api.vercel.com/v5/user/tokens/tokenId', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

{
  "token": {
    "activeAt": "1632816536002",
    "createdAt": "1632816536002",
    "expiresAt": "1632816536002",
    "id": "5d9f2ebd38ddca62e5d51e9c1704c72530bdc8bfdd41e782a6687c48399e8391",
    "leakedAt": "1632816536002",
    "leakedUrl": "https://example.com",
    "name": "Example Name",
    "origin": "github",
    "prefix": "vcp_",
    "revokedAt": "1632816536002",
    "scopes": [
      {
        "createdAt": "123",
        "expiresAt": "123",
        "origin": "app",
        "sudo": {
          "expiresAt": "123",
          "origin": "email-otp",
          "verifiedAt": "123"
        },
        "type": "user"
      }
    ],
    "suffix": "abc123",
    "type": "oauth2-token"
  }
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

tokenIdstringRequired

The identifier of the token to retrieve. The special value "current" may be supplied, which returns the metadata for the token that the current HTTP request is authenticated with.

Response

200Successful response.

tokenobjectRequired

Authentication token metadata.

Errors

400One of the provided values in the request query is invalid.

403You do not have permission to access this resource.

404Token not found with the requested `tokenId`.

410Error

Cross-link map: Get Auth Token Metadata (/docs/rest-api/authentication/get-auth-token-metadata)

From the Vercel docs graph (built 2026-10-08T05:38:39.548Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.json

Semantically closest pages

List Auth Tokens — GET /v6/user/tokens — Retrieve a list of the current User's authentication tokens.
Create an Auth Token — POST /v3/user/tokens — Creates and returns a new authentication token for the currently authenticated User. The \`bearer
Delete an authentication token — DELETE /v3/user/tokens/{tokenId} — Invalidate an authentication token, such that it will no longer be valid for future H
Authentication — Endpoints in the authentication group of the Vercel REST API Reference.
Get Global Config token meta data — GET /v1/global-config/{edgeConfigId}/token/{token} — Return meta data about a Global Config token.

This page links to (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

Pages that link here (2)

By site: vercel-docs (2)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.
Authentication — Endpoints in the authentication group of the Vercel REST API Reference.

https://api.vercel.com/v5/user/tokens/{tokenId}

const response = await fetch('https://api.vercel.com/v5/user/tokens/tokenId', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

{
  "token": {
    "activeAt": "1632816536002",
    "createdAt": "1632816536002",
    "expiresAt": "1632816536002",
    "id": "5d9f2ebd38ddca62e5d51e9c1704c72530bdc8bfdd41e782a6687c48399e8391",
    "leakedAt": "1632816536002",
    "leakedUrl": "https://example.com",
    "name": "Example Name",
    "origin": "github",
    "prefix": "vcp_",
    "revokedAt": "1632816536002",
    "scopes": [
      {
        "createdAt": "123",
        "expiresAt": "123",
        "origin": "app",
        "sudo": {
          "expiresAt": "123",
          "origin": "email-otp",
          "verifiedAt": "123"
        },
        "type": "user"
      }
    ],
    "suffix": "abc123",
    "type": "oauth2-token"
  }
}

OpenAPI Specification