# discoverByIdentityKey

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

**POST** `/discoverByIdentityKey`

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

Discovers certificates by identity key

## Body

Content type: `application/json`

- `identityKey` (string)
- `limit` (integer)
- `offset` (integer)
- `seekPermission` (boolean)

Example:

```json
{
  "identityKey": "string",
  "limit": 0,
  "offset": 0,
  "seekPermission": true
}
```

## Responses

### 200

The discovered 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