# List Company Certificates

## GET /v1/companycert/list

> List all trusted certs

```json
{"openapi":"3.1.1","info":{"title":"Pod API","version":"20.17.1"},"servers":[{"url":"http://yourpodURL.symphony.com/pod"}],"paths":{"/v1/companycert/list":{"get":{"summary":"List all trusted certs","parameters":[{"schema":{"type":"string"},"name":"sessionToken","description":"Session authentication token.","in":"header","required":true},{"schema":{"type":"integer"},"name":"skip","description":"Pagination start","in":"query","required":false},{"schema":{"type":"integer"},"name":"limit","description":"Row limit","in":"query","required":false}],"tags":["Security"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompanyCertInfoList"}}}},"400":{"description":"Client error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"description":"Unauthorized: Invalid session token.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"403":{"description":"Forbidden: Caller lacks necessary entitlement.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"500":{"description":"Server error, see response body for further details.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"CompanyCertInfoList":{"type":"array","items":{"type":"object","properties":{"companyCertAttributes":{"$ref":"#/components/schemas/CompanyCertAttributes"},"companyCertInfo":{"$ref":"#/components/schemas/CompanyCertInfo"}}}},"CompanyCertAttributes":{"type":"object","properties":{"name":{"type":"string","description":"Friendly name assigned by administrator"},"type":{"$ref":"#/components/schemas/CompanyCertType"},"status":{"$ref":"#/components/schemas/CompanyCertStatus"}}},"CompanyCertType":{"type":"object","properties":{"type":{"type":"string","enum":["USERSIGNING","USER","OPERATIONSSIGNING","OPERATIONSUSER"]}}},"CompanyCertStatus":{"type":"object","properties":{"type":{"type":"string","enum":["TRUSTED","KNOWN","REVOKED","DISABLED"]}}},"CompanyCertInfo":{"type":"object","properties":{"fingerPrint":{"type":"string","description":"Unique identifier"},"issuerFingerPrint":{"type":"string","description":"Unique identifier of issuer cert if known"},"lastSeen":{"type":"integer","format":"int64","description":"Date when we last saw this certificate presented"},"updatedAt":{"type":"integer","format":"int64","description":"Date when this cert was last updated by administrator"},"updatedBy":{"type":"integer","format":"int64","description":"User ID of administrator who last updated this cert"},"commonName":{"type":"string","description":"The Symphony account name which this certificate authenticates"},"expiryDate":{"type":"integer","format":"int64","description":"Expiry date of this cert"}}},"Error":{"type":"object","properties":{"code":{"type":"integer","format":"int32"},"message":{"type":"string"}}}}}}
```

> #### 🚧 Role and privileges
>
> Calling this endpoint requires the USER\_PROVISIONING or the SUPER\_ADMINISTRATOR role.\
> See [Bot Permissions](https://docs.developers.symphony.com/building-bots-on-symphony/configuration/bot-permissions) for a list of roles and associated privileges.