Get an application API grant
GET /v1/applications/{application_id}/api-grants/{api_id} · permission applications:write
Returns the scopes an application may request for one API, and the scopes granted by default.
Request
| Parameter | In | Description |
|---|---|---|
application_id |
path | Application id (app_…). |
api_id |
path | API id (api_…). |
Response
200 OK.
{
"application_id": "app_6f8d0cjgbmf0gtn2rg6pscp3cg",
"api_id": "api_0000000000000000000000001z",
"scopes": ["orders:read", "orders:write"],
"default_scopes": ["orders:read"],
"created_at": "2026-10-05T10:00:01Z",
"updated_at": "2026-10-05T10:00:01Z"
}
Errors
| HTTP | code |
When |
|---|---|---|
| 401 | unauthenticated |
The key is missing, invalid or revoked. |
| 403 | insufficient_permissions |
The key lacks the required permission. |
| 404 | not_found |
The application or the grant does not exist in this environment. |
Example
curl https://api.eu.keenauth.com/v1/applications/app_6f8d0cjgbmf0gtn2rg6pscp3cg/api-grants/api_0000000000000000000000001z \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"