List Grants

Retrieve a list of OAuth grants for the authenticated team.

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.

Query Parameters

  {isRequired ?

limit (number) — Number of OAuth grants to retrieve.
- Default value: 20
- Maximum value: 100
- Minimum value: 1

: <>

Note that the limit parameter is optional. If you do not provide a limit, all OAuth grants will be returned in a single response.

limit (number) — Number of OAuth grants to retrieve.
- Maximum value: 100
- Minimum value: 1
```
</>}
```
  - after (string) — The ID after which we'll retrieve more OAuth grants (for pagination). This ID will not be included in the returned list. Cannot be used with the before parameter.
  - before (string) — The ID before which we'll retrieve more OAuth grants (for pagination). This ID will not be included in the returned list. Cannot be used with the after parameter.
    
    You can only use either after or before parameter, not both. See our pagination guide for more information.
  </>

Node.js

import { Resend } from 'resend';

const resend = new Resend('re_xxxxxxxxx');

const { data, error } = await resend.oauthGrants.list();

Rust

use resend_rs::{Resend, Result, list_opts::ListOptions};

#[tokio::main]
async fn main() -> Result<()> {
  let resend = Resend::new("re_xxxxxxxxx");

  let _data = resend.oauth.list(ListOptions::default()).await?;

  Ok(())
}

cURL

curl -X GET 'https://api.resend.com/oauth/grants' \
     -H 'Authorization: Bearer re_xxxxxxxxx'

CLI

resend oauth-grants list

Response

{
  "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"
      }
    }
  ]
}