---
title: List Custom CSRs
---

[Skip to content](#%5Ftop) 

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

[Custom Csrs](https://developers.cloudflare.com/api/python/resources/custom%5Fcsrs)

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](https://developers.cloudflare.com/api/python/resources/custom%5Fcsrs#%28resource%29%20custom%5Fcsrs%20%3E%20%28model%29%20custom%5Fcsr%5Flist%5Fresponse%20%3E%20%28schema%29)\]

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`

##### ParametersExpand Collapse 

account\_id: Optional\[str\]

The Account ID to use for this endpoint. Mutually exclusive with the Zone ID.

zone\_id: Optional\[str\]

The Zone ID to use for this endpoint. Mutually exclusive with the Account ID.

direction: Optional\[Literal\["asc", "desc"\]\]

The direction to sort by.

One of the following:

"asc"

"desc"

order: Optional\[Literal\["name", "account\_tag", "created\_at"\]\]

The field to sort the returned custom CSRs by.

One of the following:

"name"

"account\_tag"

"created\_at"

page: Optional\[float\]

Page number of paginated results.

minimum1

per\_page: Optional\[float\]

Number of custom CSRs per page.

maximum50

minimum5

##### ReturnsExpand Collapse 

class CustomCsrListResponse: …

A custom Certificate Signing Request (CSR).

id: str

Custom CSR identifier tag.

maxLength36

created\_at: datetime

When the CSR was created.

formatdate-time

key\_type: Literal\["rsa2048", "p256v1"\]

The key algorithm used to generate the CSR.

One of the following:

"rsa2048"

"p256v1"

account\_tag: Optional\[str\]

Account identifier associated with this CSR.

common\_name: Optional\[str\]

The common name (domain) for the CSR.

maxLength64

country: Optional\[str\]

Two-letter ISO 3166-1 alpha-2 country code.

csr: Optional\[str\]

The PEM-encoded Certificate Signing Request.

description: Optional\[str\]

Optional description for the CSR.

locality: Optional\[str\]

City or locality name.

name: Optional\[str\]

Human-readable name for the CSR.

organization: Optional\[str\]

Organization name.

organizational\_unit: Optional\[str\]

Organizational unit name.

sans: Optional\[List\[str\]\]

Subject Alternative Names included in the CSR.

state: Optional\[str\]

State or province name.

### List Custom CSRs

Python

HTTPHTTP

TypeScriptTypeScript

PythonPython

GoGo

TerraformTerraform

```
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
  }
}
```