# Evaluations

## List Evaluations

> List evaluations. Requires the 'evaluations:read' scope.

```json
{"openapi":"3.0.1","info":{"title":"Opine API","version":"1.0.0"},"servers":[{"url":"https://api.tryopine.com","description":"Production server"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication"}},"schemas":{"ListEvaluations200ResponseBody":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"publicId":{"type":"string"},"createdAt":{"type":"string","format":"date-time"},"updatedAt":{"type":"string","format":"date-time"},"title":{"type":"string"},"description":{"nullable":true,"type":"string"},"active":{"default":true,"type":"boolean"},"organizationId":{"type":"number"},"createdByUserId":{"nullable":true,"type":"number"},"accessCode":{"type":"string"},"buyerAccessLevel":{"nullable":true,"type":"string","enum":["RESTRICTED","ANYONE_WITH_LINK"]},"mode":{"default":"PLAN","type":"string","enum":["PLAN","NO_PLAN","DRAFT"]},"brandingColorHex":{"nullable":true,"type":"string"},"startDate":{"nullable":true,"type":"string","format":"date-time"},"targetEndDate":{"nullable":true,"type":"string","format":"date-time"},"buyerNotificationsEnabled":{"type":"boolean"},"currentStageId":{"nullable":true,"type":"number"},"currentProcessPositionRank":{"nullable":true,"type":"string"},"allProcessesPositionRank":{"nullable":true,"type":"string"},"derivedFromTemplateId":{"nullable":true,"type":"number"},"salesProcessId":{"nullable":true,"type":"number"},"defaultAssigneeUserId":{"nullable":true,"type":"number"}},"required":["id","publicId","createdAt","updatedAt","title","description","active","organizationId","createdByUserId","accessCode","buyerAccessLevel","mode","brandingColorHex","startDate","targetEndDate","buyerNotificationsEnabled","currentStageId","currentProcessPositionRank","allProcessesPositionRank","derivedFromTemplateId","salesProcessId","defaultAssigneeUserId"],"additionalProperties":false}},"limit":{"type":"number"},"offset":{"type":"number"},"totalCount":{"type":"number"}},"required":["items","limit","offset","totalCount"],"additionalProperties":false},"ErrorMessage":{"type":"object","properties":{"message":{"type":"string"}},"additionalProperties":false}}},"paths":{"/v1/evaluations":{"get":{"operationId":"listEvaluations","responses":{"200":{"description":"Response for status 200","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEvaluations200ResponseBody"}}}},"500":{"description":"An unknown error occurred, trying again might help.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessage"}}}}},"summary":"List Evaluations","description":"List evaluations. Requires the 'evaluations:read' scope.","tags":["evaluations"],"parameters":[{"name":"limit","in":"query","description":"The number of results to return","required":false,"schema":{"type":"number","minimum":1,"maximum":1000,"default":100}},{"name":"offset","in":"query","description":"The number of results to skip","required":false,"schema":{"type":"number","minimum":0,"default":0}}]}}}}
```