---
title: "What this token can do"
method: GET
path: "/api/v1/me"
tags: ["Partners"]
---

# What this token can do

`GET /api/v1/me`

## Request

- Base URL: `https://www.upgradeagent.ai`
- URL: `https://www.upgradeagent.ai/api/v1/me`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://www.upgradeagent.ai/api/oauth/authorize`, token URL `https://www.upgradeagent.ai/api/oauth/token`, scopes: `mcp`)
  - HTTP bearer

The caller's kind (platform credential vs OAuth client), client id, and partner scope. A partner-scoped token is limited to its own carrier on every quote/offer/pricing/partner call (`carrier` may be omitted and is filled in); the response names that partner and its white-label MCP server.

## Response `200`

The token's scope.

- TokenScope
  - `kind` 'oauth' | 'static', required
  - `clientId` string, nullable, required
  - `scopes` string[], required
  - `partner` object, nullable, required
    - `code` string, required: IATA / partner code.
    - `name` string, required
    - `slug` string, required
    - `mcpServer` string, required: The partner's white-label MCP server URL.
    - `serverCard` string, required: The partner's server card URL.
    - `note` string
  - `mcpServer` string, required: The MCP server this token should use (partner server for a scoped token).
  - `channel` 'rest' | 'rest-partner', required

## Other responses

- `401`: Missing, invalid, expired, or revoked bearer token. The WWW-Authenticate challenge points at the OAuth protected-resource metadata.
- `429`: Per-caller rate limit exceeded.

---

[API](https://skmtc.dev/upgradeagent/apis/upgrade-agent-rest-api.md) · [All operations](https://skmtc.dev/upgradeagent/apis/upgrade-agent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/upgradeagent/apis/upgrade-agent-rest-api/revisions/fbed715712c1?raw)