---
title: OAuth Scopes
---

[Skip to content](#_top)

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

[IAM](https://developers.cloudflare.com/api/python/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/python/resources/iam/subresources/oauth_scopes/methods/list)

iam.oauth\_scopes.list() -> SyncSinglePage\[[OAuthScopeListResponse](<https://developers.cloudflare.com/api/python/resources/iam#(resource)%20iam.oauth_scopes%20%3E%20(model)%20oauth_scope_list_response%20%3E%20(schema)>)]

GET/oauth/scopes

##### ModelsExpand Collapse

<details>

<summary>

class OAuthScopeListResponse: …

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

</summary>

id: str

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: str

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: Optional\[str]

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: Optional\[List\[str]]

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)>)