# List certificates in the MDM certificate repository with filtering and pagination

Get the list of certificates uploaded to the MDM certificate repository. Supports filtering by name, identity type, and certificate type with cursor-based pagination.

## Endpoint

`GET /api/v1/mdm/profiles/certificates`

## Request

### Request URL

`https://{server-hostname}:8383/api/v1/mdm/profiles/certificates`

### Scope

`MDMDeviceMgmt.READ`

### Header

`Authorization: d92d4xxxxxxxxxxxxx15f52`

### Request Parameters

#### Request Headers

- **Accept** `string` — Mandatory: `application/json`

#### Query Parameters

- **limit** `integer` — Optional  
  Maximum number of records to return in a single response. Used together with offset for pagination
- **skip-token** `string` — Optional
- **offset** `integer` — Optional  
  Zero-based index of the first record to return. Used together with limit for pagination
- **delta-token** `string` — Optional  
  Token used for delta/incremental fetches. Pass the token returned from a previous response to retrieve only items modified since that point
- **search** `string` — Optional
- **identity** `boolean` — Optional
- **exclude_distribution_details** `boolean` — Optional
- **type** `integer` — Optional

### Sample Request

```curl
curl --request GET \
  --url 'https://appdomain/api/v1/mdm/profiles/certificates?limit=SOME_INTEGER_VALUE&skip-token=SOME_STRING_VALUE&offset=SOME_INTEGER_VALUE&delta-token=SOME_STRING_VALUE&search=SOME_STRING_VALUE&identity=SOME_BOOLEAN_VALUE&exclude_distribution_details=SOME_BOOLEAN_VALUE&type=SOME_INTEGER_VALUE' \
  --header 'Accept: application/json' \
  --header 'Authorization:  d92d4xxxxxxxxxxxxx15f52'
```

## Response

### Response Parameters

#### HTTP Code 200

Response body: `application/json`

- `JSON Object`
  - **certificates** `JSON Array`  
    Array of certificate objects matching the query filters
  - **metadata** `JSON Object`  
    Pagination metadata including total record count
  - **paging** `JSON Object`  
    Pagination links for navigating result pages. Present only when results are paginated

### Possible Response Codes

- **200** — HTTP code

### Sample Response: HTTP 200

List of certificates with pagination metadata:

```json
{
  "metadata": {
    "total_record_count": "7"
  },
  "certificates": [
    {
      "days_to_expire": "343",
      "certificate_name": "APSP:99335a61-7acc-42a0-87fd-f564d36e2166",
      "is_identity": false,
      "certificate_notafter": "1572518494000",
      "certificate_org": "",
      "issuer_name": "Apple Application Integration 2 Certification Authority",
      "certificate_id": "9007199254741001",
      "certificate_issuer_dn": "C=US,O=Apple Inc.,OU=Apple Certification Authority,CN=Apple Application Integration 2 Certification Authority",
      "issuer_org": "Apple Inc.",
      "certificate_notbefore": "1540982494000",
      "certificate_subject_dn": "C=US, CN=APSP:99335a61-7acc-42a0-87fd-f564d36e2166, UID=com.apple.mgmt.External.99335a61-7acc-42a0-87fd-f564d36e2166",
      "certificate_file_name": "MDM__Zylker_Inc_Certificate__5_.pem",
      "certificate_serial_number": "7565549844070638883"
    },
    {
      "days_to_expire": "7305",
      "certificate_name": "ZylkerCA",
      "is_identity": false,
      "certificate_notafter": "2174000445000",
      "certificate_org": "Zylker Inc",
      "issuer_name": "ZylkerCA",
      "certificate_id": "9007199254741007",
      "certificate_issuer_dn": "CN=ZylkerCA,O=Zylker Inc,OU=Zylker IT,ST=CA,C=US",
      "issuer_org": "Zylker Inc",
      "certificate_notbefore": "1542848445000",
      "certificate_subject_dn": "CN=ZylkerCA, O=Zylker Inc, OU=Zylker IT, ST=CA, C=US",
      "certificate_file_name": "cert",
      "certificate_serial_number": "2751265269709804611"
    }
  ],
  "paging": {
    "next": "https://server/api/v1/mdm/profiles/certificates?skip-token=Mzo3OjE6MTU0Mjg4NjY0NDEyNw%3D%3D",
    "previous": "https://server/api/v1/mdm/profiles/certificates?skip-token=MzoxOjI6MTU0Mjg4NjcyODY1MA%3D%3D"
  }
}
```

No certificates found matching the query:

```json
{
  "metadata": {
    "total_record_count": "0"
  },
  "certificates": [],
  "paging": {}
}
```

## Rate Limits

![](https://www.zohowebstatic.com/sites/zweb/images/people/ico-help.png)

**Duration:** 1 minute | **Threshold:** 120 | **Lock period:** 5 minutes

Duration - Time window for the threshold.  
Threshold - Number of API calls allowed within the specified duration.  
Lock Period - Wait time before consecutive API requests.