---
title: "Check the current REST buyer authorization"
method: GET
path: "/agent/auth"
tags: ["Authorization"]
---

# Check the current REST buyer authorization

`GET /agent/auth`

## Request

- Base URL: `https://vesremont.com`
- URL: `https://vesremont.com/agent/auth`
- Auth: OAuth 2 (authorization code, authorization URL `https://vesremont.com/oauth/authorize`, token URL `https://vesremont.com/oauth/token`)

GET/HEAD requires an existing REST-audience buyer access token with nonempty granted scopes. Rechecks its live buyer-session binding and revocation, without reading cart, contacts or orders. Returns only resource, granted scopes and expiry. Does not issue credentials, add scopes or confirm an order. Anonymous catalog credentials are not buyer grants.

## Response `200`

Current authorization, no buyer identity data.

- object
  - `authenticated` unknown, required
  - `resource` 'https://vesremont.com/api/v1', required
  - `scopes` string[], required
  - `expires_at` integer, required
  - `buyer_session_verified` unknown, required

## Other responses

- `400`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `401`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `403`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `405`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `406`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `413`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `415`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `422`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `429`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.
- `503`: Structured failure. The code is stable; do not retry uncertain order writes with a new key.

---

[API](https://skmtc.dev/vesremont/apis/vesremont-public-api.md) · [All operations](https://skmtc.dev/vesremont/apis/vesremont-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vesremont/apis/vesremont-public-api/revisions/3bfec100b67d?raw)