--- title: List Custom CSRs --- [Skip to content](#%5Ftop) [API Reference](https://developers.cloudflare.com/api) [Custom Csrs](https://developers.cloudflare.com/api/resources/custom%5Fcsrs) Copy Markdown Open in **Claude** Open in **ChatGPT** Open in **Cursor** --- **Copy Markdown** **View as Markdown** # List Custom CSRs 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](https://developers.cloudflare.com/fundamentals/api/get-started/create-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` ##### Path ParametersExpand Collapse account\_id: optional string The Account ID to use for this endpoint. Mutually exclusive with the Zone ID. zone\_id: optional string The Zone ID to use for this endpoint. Mutually exclusive with the Account ID. ##### Query ParametersExpand Collapse direction: optional "asc" or "desc" The direction to sort by. One of the following: "asc" "desc" order: optional "name" or "account\_tag" or "created\_at" The field to sort the returned custom CSRs by. One of the following: "name" "account\_tag" "created\_at" page: optional number Page number of paginated results. minimum1 per\_page: optional number Number of custom CSRs per page. maximum50 minimum5 ##### ReturnsExpand Collapse errors: array of object { code, message, documentation\_url, source } code: number minimum1000 message: string documentation\_url: optional string source: optional object { pointer } pointer: optional string messages: array of object { code, message, documentation\_url, source } code: number minimum1000 message: string documentation\_url: optional string source: optional object { pointer } pointer: optional string success: true Whether the API call was successful. result: optional array of object { id, created\_at, key\_type, 11 more } id: string Custom CSR identifier tag. maxLength36 created\_at: string When the CSR was created. formatdate-time key\_type: "rsa2048" or "p256v1" The key algorithm used to generate the CSR. One of the following: "rsa2048" "p256v1" account\_tag: optional string Account identifier associated with this CSR. common\_name: optional string The common name (domain) for the CSR. maxLength64 country: optional string Two-letter ISO 3166-1 alpha-2 country code. csr: optional string The PEM-encoded Certificate Signing Request. description: optional string Optional description for the CSR. locality: optional string City or locality name. name: optional string Human-readable name for the CSR. organization: optional string Organization name. organizational\_unit: optional string Organizational unit name. sans: optional array of string Subject Alternative Names included in the CSR. state: optional string State or province name. result\_info: optional object { count, page, per\_page, 2 more } count: optional number Total number of results for the requested service. page: optional number Current page within paginated list of results. per\_page: optional number Number of results per page of results. total\_count: optional number Total results available without any search parameters. total\_pages: optional number The number of total pages in the entire result set. ### List Custom CSRs HTTP HTTPHTTP TypeScriptTypeScript PythonPython GoGo TerraformTerraform ``` curl https://api.cloudflare.com/client/v4/$ACCOUNTS_OR_ZONES/$ACCOUNT_OR_ZONE_ID/custom_csrs \ -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" ``` 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 } } ```