# List certificate revocations (/docs/apis/management/trust-stores/GetAllRevocations)

`GET /truststores/pki/{trust_store_id}/revocations`

Retrieves a paginated list of certificate revocations (offline CRLs) configured for the specified trust store. Optional query parameters allow sorting of the results.

Base URL: `https://{tenant}.{region}.monocloud.com/api`, where `{tenant}`, `{region}` (one of us, eu, in) come from your tenant. Authentication: send your Management API key in the `X-API-KEY` header.

## Parameters

- `trust_store_id` (path) (string, required) The unique identifier of the trust store.
- `page` (query) (integer, int32, default 1) The page number to retrieve.
- `size` (query) (integer, int32, default 10) The number of revocations to return per page.
- `sort` (query) (string) Sort expression in the format `field:direction`, where direction is `1` for ascending or `-1` for descending. Supported fields include - `creation_time` and `issued_at`

## Response body

`200`, JSON. The certificate revocations were retrieved successfully

Returns `RevocationGrouped[]`. Each item has these fields:

- `id` (string, required) The unique identifier of the revocation entry.
- `value` (string, required) The certificate revocation list (CRL) in PEM format.
- `issuer_thumbprint` (string, required) The thumbprint of the CA certificate that issued this CRL.
- `issued_at` (integer, required, date-time) Specifies the time at which the CRL was issued (in Epoch).
- `next_update` (integer, date-time) Specifies the time at which the next CRL update is expected (in Epoch).
- `creation_time` (integer, required, date-time) Specifies the time at which this revocation entry was created (in Epoch).
- `crl_number` (integer, int32) The CRL number, as defined in the X.509 CRL extensions, used to identify the version or sequence of the certificate revocation list.
- `deltas` (RevocationGroupedDelta[], required) Delta CRLs that provide incremental revocation updates for this base CRL.
  - `id` (string, required) The unique identifier of the delta revocation entry.
  - `value` (string, required) The certificate revocation list (CRL) in PEM format.
  - `issuer_thumbprint` (string, required) The thumbprint of the CA certificate that issued this CRL.
  - `issued_at` (integer, required, date-time) Specifies the time at which the CRL was issued (in Epoch).
  - `next_update` (integer, date-time) Specifies the time at which the next CRL update is expected (in Epoch).
  - `creation_time` (integer, required, date-time) Specifies the time at which this revocation entry was created (in Epoch).
  - `crl_number` (integer, required, int32) The base CRL number, as defined in the X.509 CRL extensions, identifying the full CRL on which this delta CRL is based.
  - `delta_crl_number` (integer, required, int32) The delta CRL number, as defined in the X.509 CRL extensions, identifying the sequence number of this delta update.
  - `base_revocation_id` (string, required) The unique identifier of the base (full) revocation entry to which this delta CRL applies.

## Errors

- `400` Bad Request
  - `type` (string, required) A URI reference that identifies the error type. When accessed, it may provide human-readable documentation.
  - `title` (string, required) A short, human-readable summary of the error.
  - `status` (integer, required, int32) The HTTP status code associated with this error response.
  - `trace_id` (string, required) A unique identifier for the request, used for tracing and diagnostics.
  - `detail` (string) A human-readable explanation specific to this occurrence of the error.
  - `instance` (string) A URI reference that identifies the specific occurrence of the error.
- `401` Unauthorized
- `403` Forbidden
- `404` Not Found
  Same body as `400`.
- `422` Unprocessable Entity
  - `type` (string, required) A URI reference that identifies the error type. When accessed, it may provide human-readable documentation.
  - `title` (string, required) A short, human-readable summary of the error.
  - `status` (integer, required, int32) The HTTP status code associated with this error response.
  - `trace_id` (string, required) A unique identifier for the request, used for tracing and diagnostics.
  - `detail` (string) A human-readable explanation specific to this occurrence of the error.
  - `instance` (string) A URI reference that identifies the specific occurrence of the error.
  - `errors` (Record<string, string[]>, required) A key-value map of validation errors, where each key represents a request field and the value contains one or more messages describing why the request could not be processed.

## Example (MonoCloud .NET SDK)

```csharp
using MonoCloud.Management;
using MonoCloud.Management.Core.Base;

var apiClient = new MonoCloudManagementClient(new MonoCloudConfig("<your-domain>", "[[API-Key]]"));


var trustStoreId = "9qVBxPQiZqtUsBOykavK6";

var page = 1;

var size = 10;

var sort = "creation_time:1";


var result = await apiClient.TrustStores.GetAllRevocationsAsync(trustStoreId, page, size, sort);
```

## Example (MonoCloud Javascript SDK)

```javascript
import { MonoCloudManagementClient } from '@monocloud/management';

const apiClient = MonoCloudManagementClient.init({ domain: '<your-domain>', apiKey: '[[API-Key]]' });

const trustStoreId = '9qVBxPQiZqtUsBOykavK6';

const page = 1;

const size = 10;

const sort = 'creation_time:1';

const result = apiClient.trustStores.getAllRevocations(trustStoreId, page, size, sort);
```