---
title: OAuth Scopes
---

[Skip to content](#_top)

[API Reference](https://developers.cloudflare.com/api/typescript)

[IAM](https://developers.cloudflare.com/api/typescript/resources/iam)

Copy Markdown

Open in **Claude**Open in **ChatGPT**Open in **Cursor**

---

**Copy Markdown****View as Markdown**

# OAuth Scopes

##### [List OAuth Scopes](https://developers.cloudflare.com/api/typescript/resources/iam/subresources/oauth_scopes/methods/list)

client.iam.oauthScopes.list(RequestOptionsoptions?): SinglePage< [OAuthScopeListResponse](<https://developers.cloudflare.com/api/typescript/resources/iam#(resource)%20iam.oauth_scopes%20%3E%20(model)%20oauth_scope_list_response%20%3E%20(schema)>) {id, name, category, scopes } >

GET/oauth/scopes

##### ModelsExpand Collapse

<details>

<summary>

OAuthScopeListResponse {id, name, category, scopes }

An available OAuth scope that can be assigned to an OAuth client.

</summary>

id: string

The scope label to use in the scopes array when creating or updating an OAuth client.

<a href="#(resource)%20iam.oauth_scopes%20%3E%20(model)%20oauth_scope_list_response%20%3E%20(schema)%20%3E%20(property)%20id">Link to this property</a>

name: string

Human-readable name of the OAuth scope.

<a href="#(resource)%20iam.oauth_scopes%20%3E%20(model)%20oauth_scope_list_response%20%3E%20(schema)%20%3E%20(property)%20name">Link to this property</a>

category?: string

Category for grouping scopes in the UI.

<a href="#(resource)%20iam.oauth_scopes%20%3E%20(model)%20oauth_scope_list_response%20%3E%20(schema)%20%3E%20(property)%20category">Link to this property</a>

scopes?: Array&lt;string&gt;

The underlying resource scopes (Bach scopes) that define which resources this OAuth scope can act upon.

<a href="#(resource)%20iam.oauth_scopes%20%3E%20(model)%20oauth_scope_list_response%20%3E%20(schema)%20%3E%20(property)%20scopes">Link to this property</a>

</details>

[Link to this property](<#(resource)%20iam.oauth_scopes%20%3E%20(model)%20oauth_scope_list_response%20%3E%20(schema)>)