Skip to main content
GET
/
oauth
/
grants
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.oauthGrants.list();
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "650e8400-e29b-41d4-a716-446655440001",
      "client_id": "430eed87-632a-4ea6-90db-0aace67ec228",
      "scopes": ["emails:send"],
      "resource": null,
      "created_at": "2026-04-08 00:11:13.110779+00",
      "revoked_at": null,
      "revoked_reason": null,
      "client": {
        "name": "Resend CLI",
        "logo_uri": "https://example.com/logo.png"
      }
    },
    {
      "id": "650e8400-e29b-41d4-a716-446655440002",
      "client_id": "430eed87-632a-4ea6-90db-0aace67ec228",
      "scopes": ["emails:send", "domains:read"],
      "resource": "https://api.resend.com",
      "created_at": "2026-04-07 00:11:13.110779+00",
      "revoked_at": "2026-04-09 00:11:13.110779+00",
      "revoked_reason": "revoked_from_api",
      "client": {
        "name": "Resend CLI",
        "logo_uri": "https://example.com/logo.png"
      }
    }
  ]
}
Returns all of the team’s OAuth grants, including revoked ones. A grant’s revoked_at and revoked_reason are null while it is active. They are set once the grant is revoked.
import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.oauthGrants.list();
{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "650e8400-e29b-41d4-a716-446655440001",
      "client_id": "430eed87-632a-4ea6-90db-0aace67ec228",
      "scopes": ["emails:send"],
      "resource": null,
      "created_at": "2026-04-08 00:11:13.110779+00",
      "revoked_at": null,
      "revoked_reason": null,
      "client": {
        "name": "Resend CLI",
        "logo_uri": "https://example.com/logo.png"
      }
    },
    {
      "id": "650e8400-e29b-41d4-a716-446655440002",
      "client_id": "430eed87-632a-4ea6-90db-0aace67ec228",
      "scopes": ["emails:send", "domains:read"],
      "resource": "https://api.resend.com",
      "created_at": "2026-04-07 00:11:13.110779+00",
      "revoked_at": "2026-04-09 00:11:13.110779+00",
      "revoked_reason": "revoked_from_api",
      "client": {
        "name": "Resend CLI",
        "logo_uri": "https://example.com/logo.png"
      }
    }
  ]
}