For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/auth/oauth-authorize-details.md.

Describe an authorization request

GET
/oauth/authorize/details

What the consent screen renders: who is asking, for what, and whether we vouch for the name.

It validates the same request /oauth/authorize did, so the screen cannot be made to describe a grant that would not actually be issued.

unverified is true for a client that registered itself and chose its own name. redirect_host is shown beside the name because the host is the part a client cannot assert freely.

Query Parameters

client_id*string
redirect_uri*string
Formaturi
response_type*"code"
Value in"code"
code_challenge*string
code_challenge_method*"S256"
Value in"S256"
resource*string
Formaturi
scope?string
state?string

Response Body

The request as the consent screen should present it

application/json
  1. response
client_id*string
client_name*string

Always the client's own claim; the callback host is not.

redirect_host*string

Host of the callback this grant would be returned to.

scopes*array<string>
vendor*string

The allowlist family whose rule admitted this client.

verification*string

What the authorization server can vouch for, based on where the grant is delivered rather than on the name. vendor — the callback belongs to a recognised host, so only that vendor can receive the code. local — a loopback callback, so a program on the user's own machine, which cannot be identified further.

Value in"vendor""local"
dynamically_registered*boolean

True for a self-registered client, whose name is its own unvetted claim; the consent screen labels the name accordingly.

Example Request
curl -X GET 'https://api.truemarkets.co/v1/auth/oauth/authorize/details?client_id=string&redirect_uri=http%3A%2F%2Fexample.com&response_type=code&code_challenge=string&code_challenge_method=S256&resource=http%3A%2F%2Fexample.com'
Example Response
{  "client_id": "string",  "client_name": "string",  "redirect_host": "string",  "scopes": [    "string"  ],  "vendor": "string",  "verification": "vendor",  "dynamically_registered": true}