Skip to main content

Get Application Info

Get OAuth application information for consent screen (public endpoint).

Endpoint​

GET /api/v1/oauth/app-info

Headers​

No authentication required (public endpoint).

Query Parameters​

ParameterTypeRequiredDescription
client_idstringYesOAuth application client ID
redirect_uristringYesRedirect URI to validate
scopestringNoSpace-separated list of requested scopes

Response​

Success (200)​

{
  "success": true,
  "data": {
    "app_name": "My OAuth App",
    "description": "Application description",
    "scopes": ["read", "write"],
    "requested_scopes": ["read", "write"],
    "organization_name": "Acme Corp"
  },
  "message": "Application information retrieved successfully"
}

Error (400)​

{
  "success": false,
  "error": {
    "code": "invalid_client",
    "message": "Invalid client_id"
  }
}

Features​

  • Public endpoint (no authentication required)
  • Used by frontend to fetch app details before showing consent screen
  • Validates client_id and redirect_uri
  • Returns app name, description, available scopes, and requested scopes
  • Validates requested scopes are subset of application scopes

Example​

curl -X GET "https://api.rivergen.com/api/v1/oauth/app-info?client_id=CLIENT_ID&redirect_uri=https://myapp.com/callback&scope=read write"