# GET /api/v1/oauth/grants/:client_id

Auth: Bearer

HTML: https://cooperemail.com/docs/reference/oauth-grant

## Summary

One connected app for this account. Same fields as the list. Another account's client, or a client with no usable token here, returns 404 oauth_grant_not_found. Requires key_read. An inbox-scoped key receives 403 permission_denied.

## Request

This call has no JSON body.

## Response

HTTP 200. Sample values illustrate the schema.

```json
{
  "object": "oauth_grant",
  "id": "inb_example",
  "client_id": "inb_example",
  "client_name": "string",
  "redirect_hosts": [
    "string"
  ],
  "scope": "string",
  "resource": "string",
  "connected_at": "2026-10-18T12:00:00.000Z",
  "last_refreshed_at": "2026-10-18T12:00:00.000Z",
  "active_tokens": 1
}
```

## Errors

- HTTP 404 oauth_grant_not_found
- HTTP 403 permission_denied

The live `message` is the sentence for that code. Branch on `code`.

```json
{
  "error": {
    "type": "not_found",
    "code": "oauth_grant_not_found",
    "docs_url": "https://cooperemail.com/docs#oauth_grant_not_found"
  }
}
```

## Idempotency

This route does not document Idempotency-Key or client_id.