--- title: List Custom CSRs --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Custom Csrs](https://developers.cloudflare.com/api/python/resources/custom_csrs) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Custom CSRs custom\_csrs.list(CustomCsrListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[CustomCsrListResponse]()] GET/{accounts\_or\_zones}/{account\_or\_zone\_id}/custom\_csrs List all custom Certificate Signing Requests (CSRs) for an account or 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: SSL and Certificates Read``Account: SSL and Certificates Write` ##### ParametersExpand Collapse account\_id: Optional\[str] The Account ID to use for this endpoint. Mutually exclusive with the Zone ID. [Link to this property](<#(resource)%20custom_csrs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) zone\_id: Optional\[str] The Zone ID to use for this endpoint. Mutually exclusive with the Account ID. [Link to this property](<#(resource)%20custom_csrs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20zone_id%20%3E%20(schema)>)
direction: Optional\[Literal\["asc", "desc"]] The direction to sort by. One of the following: "asc" Link to this property "desc" Link to this property
[Link to this property](<#(resource)%20custom_csrs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20direction%20%3E%20(schema)>)
order: Optional\[Literal\["name", "account\_tag", "created\_at"]] The field to sort the returned custom CSRs by. One of the following: "name" Link to this property "account\_tag" Link to this property "created\_at" Link to this property
[Link to this property](<#(resource)%20custom_csrs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20order%20%3E%20(schema)>) page: Optional\[float] Page number of paginated results. minimum1 [Link to this property](<#(resource)%20custom_csrs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: Optional\[float] Number of custom CSRs per page. maximum50 minimum5 [Link to this property](<#(resource)%20custom_csrs%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class CustomCsrListResponse: … A custom Certificate Signing Request (CSR). id: str Custom CSR identifier tag. maxLength36 Link to this property created\_at: datetime When the CSR was created. formatdate-time Link to this property
key\_type: Literal\["rsa2048", "p256v1"] The key algorithm used to generate the CSR. One of the following: "rsa2048" Link to this property "p256v1" Link to this property
Link to this property account\_tag: Optional\[str] Account identifier associated with this CSR. Link to this property common\_name: Optional\[str] The common name (domain) for the CSR. maxLength64 Link to this property country: Optional\[str] Two-letter ISO 3166-1 alpha-2 country code. Link to this property csr: Optional\[str] The PEM-encoded Certificate Signing Request. Link to this property description: Optional\[str] Optional description for the CSR. Link to this property locality: Optional\[str] City or locality name. Link to this property name: Optional\[str] Human-readable name for the CSR. Link to this property organization: Optional\[str] Organization name. Link to this property organizational\_unit: Optional\[str] Organizational unit name. Link to this property sans: Optional\[List\[str]] Subject Alternative Names included in the CSR. Link to this property state: Optional\[str] State or province name. Link to this property
[Link to this property](<#(resource)%20custom_csrs%20%3E%20(model)%20custom_csr_list_response%20%3E%20(schema)>) ### List Custom CSRs 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.custom_csrs.list( account_id="account_id", ) 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" } } ], "success": true, "result": [ { "id": "7b163417-1d2b-4c84-a38a-2fb7a0cd7752", "created_at": "2024-01-15T10:30:00Z", "key_type": "rsa2048", "account_tag": "23e087bd19bc1d40ae95b6f297263ceb", "common_name": "example.com", "country": "US", "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICYzCCAUsCAQAwHj...", "description": "CSR for example.com wildcard", "locality": "San Francisco", "name": "My Custom CSR", "organization": "Cloudflare, Inc.", "organizational_unit": "Engineering", "sans": [ "example.com", "www.example.com" ], "state": "California" } ], "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" } } ], "success": true, "result": [ { "id": "7b163417-1d2b-4c84-a38a-2fb7a0cd7752", "created_at": "2024-01-15T10:30:00Z", "key_type": "rsa2048", "account_tag": "23e087bd19bc1d40ae95b6f297263ceb", "common_name": "example.com", "country": "US", "csr": "-----BEGIN CERTIFICATE REQUEST-----\nMIICYzCCAUsCAQAwHj...", "description": "CSR for example.com wildcard", "locality": "San Francisco", "name": "My Custom CSR", "organization": "Cloudflare, Inc.", "organizational_unit": "Engineering", "sans": [ "example.com", "www.example.com" ], "state": "California" } ], "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000, "total_pages": 100 } } ```