--- title: List token validation configurations --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Token Validation](https://developers.cloudflare.com/api/python/resources/token_validation) [Configuration](https://developers.cloudflare.com/api/python/resources/token_validation/subresources/configuration) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List token validation configurations token\_validation.configuration.list(ConfigurationListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[TokenConfig]()] GET/zones/{zone\_id}/token\_validation/config Lists the JWT validation configurations defined for the zone. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**X-Auth-Email: user@example.com The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194
##### Accepted Permissions (at least one required) `Account API Gateway``Account API Gateway Read``Domain API Gateway``Domain API Gateway Read` ##### ParametersExpand Collapse zone\_id: str Identifier. maxLength32 [Link to this property](<#(resource)%20token_validation.configuration%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20zone_id%20%3E%20(schema)>) page: Optional\[int] Page number of paginated results. minimum1 [Link to this property](<#(resource)%20token_validation.configuration%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: Optional\[int] Maximum number of results per page. maximum50 minimum5 [Link to this property](<#(resource)%20token_validation.configuration%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class TokenConfig: … id: str UUID. maxLength36 minLength36 Link to this property created\_at: datetime formatdate-time Link to this property
credentials: Credentials
keys: List\[CredentialsKey] One of the following:
class CredentialsKeyAPIShieldCredentialsJWTKeyRSA: … JSON representation of an RSA key.
alg: Literal\["RS256", "RS384", "RS512", 3 more] Algorithm One of the following: "RS256" Link to this property "RS384" Link to this property "RS512" Link to this property "PS256" Link to this property "PS384" Link to this property "PS512" Link to this property
Link to this property e: str RSA exponent Link to this property kid: str Key ID Link to this property kty: Literal\["RSA"] Key Type Link to this property n: str RSA modulus Link to this property
Link to this property
class CredentialsKeyAPIShieldCredentialsJWTKeyEcEs256: … JSON representation of an ES256 key alg: Literal\["ES256"] Algorithm Link to this property crv: Literal\["P-256"] Curve Link to this property kid: str Key ID Link to this property kty: Literal\["EC"] Key Type Link to this property x: str X EC coordinate Link to this property y: str Y EC coordinate Link to this property
Link to this property
class CredentialsKeyAPIShieldCredentialsJWTKeyEcEs384: … JSON representation of an ES384 key alg: Literal\["ES384"] Algorithm Link to this property crv: Literal\["P-384"] Curve Link to this property kid: str Key ID Link to this property kty: Literal\["EC"] Key Type Link to this property x: str X EC coordinate Link to this property y: str Y EC coordinate Link to this property
Link to this property
class CredentialsKeyAPIShieldCredentialsJWTKeyOctResponse: … JSON representation of a symmetric verification key in API responses (secret material is redacted).
alg: Literal\["HS256", "HS384", "HS512"] Algorithm One of the following: "HS256" Link to this property "HS384" Link to this property "HS512" Link to this property
Link to this property kid: str Key ID Link to this property kty: Literal\["oct"] Key Type Link to this property
Link to this property
Link to this property
Link to this property description: str maxLength500 Link to this property last\_updated: datetime formatdate-time Link to this property title: str maxLength50 Link to this property token\_sources: List\[str] Link to this property token\_type: Literal\["JWT"] Link to this property
[Link to this property](<#(resource)%20token_validation.configuration%20%3E%20(model)%20token_config%20%3E%20(schema)>) ### List token validation configurations Python HTTPTypeScriptPythonGoTerraform ``` import os from cloudflare import Cloudflare client = Cloudflare( api_token=os.environ.get("CLOUDFLARE_API_TOKEN"), # This is the default and can be omitted ) page = client.token_validation.configuration.list( zone_id="023e105f4ecef8ad9ca31a8372d0c353", ) page = page.result[0] print(page.id) ``` 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "created_at": "2014-01-01T05:20:00.12345Z", "credentials": { "keys": [ { "alg": "ES256", "crv": "P-256", "kid": "38013f13-c266-4eec-a72a-92ec92779f21", "kty": "EC", "x": "KN53JRwN3wCjm2o39bvZUX2VdrsHzS8pxOAGjm8m7EQ", "y": "lnkkzIxaveggz-HFhcMWW15nxvOj0Z_uQsXbpK0GFcY" } ] }, "description": "Long description for Token Validation Configuration", "last_updated": "2014-01-01T05:20:00.12345Z", "title": "Example Token Validation Configuration", "token_sources": [ "http.request.headers[\"x-auth\"][0]", "http.request.cookies[\"Authorization\"][0]" ], "token_type": "JWT" } ], "success": true, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ``` ##### Returns Examples 200 example ``` { "errors": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "messages": [ { "code": 1000, "message": "message", "documentation_url": "documentation_url", "source": { "pointer": "pointer" } } ], "result": [ { "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415", "created_at": "2014-01-01T05:20:00.12345Z", "credentials": { "keys": [ { "alg": "ES256", "crv": "P-256", "kid": "38013f13-c266-4eec-a72a-92ec92779f21", "kty": "EC", "x": "KN53JRwN3wCjm2o39bvZUX2VdrsHzS8pxOAGjm8m7EQ", "y": "lnkkzIxaveggz-HFhcMWW15nxvOj0Z_uQsXbpK0GFcY" } ] }, "description": "Long description for Token Validation Configuration", "last_updated": "2014-01-01T05:20:00.12345Z", "title": "Example Token Validation Configuration", "token_sources": [ "http.request.headers[\"x-auth\"][0]", "http.request.cookies[\"Authorization\"][0]" ], "token_type": "JWT" } ], "success": true, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ```