# listCertificates

> For the complete documentation index, see [llms.txt](https://bsvblockchain.com/docs/llms.txt).

**POST** `/listCertificates`

Base URL: `http://localhost:3321`

Lists certificates

## Body

Content type: `application/json`

- `certifiers` (string[])
- `types` (string[])
- `limit` (integer)
- `offset` (integer)
- `privileged` (boolean)
- `privilegedReason` (string)

Example:

```json
{
  "certifiers": [
    "string"
  ],
  "types": [
    "string"
  ],
  "limit": 0,
  "offset": 0,
  "privileged": false,
  "privilegedReason": "string"
}
```

## Responses

### 200

The list of certificates

- `totalCertificates` (number)
- `certificates` (object[])
  - `type` (string)
  - `subject` (string)
  - `serialNumber` (string)
  - `certifier` (string)
  - `revocationOutput` (string)
  - `signature` (string)
  - `fields` (object)

Example:

```json
{
  "totalCertificates": 0,
  "certificates": [
    {
      "type": "string",
      "subject": "string",
      "serialNumber": "string",
      "certifier": "string",
      "revocationOutput": "string",
      "signature": "string",
      "fields": {}
    }
  ]
}
```

### 400

Invalid input

### 500

Internal server error