> ## Documentation Index > Fetch the complete documentation index at: https://doc.youverify.co/llms.txt > Use this file to discover all available pages before exploring further. # List Evaluations > Lists the business's workflow runs (evaluations), cursor-paginated. Scoped to the API key's business. With no filter the list is read from MongoDB; any filter reads from Elasticsearch. ## OpenAPI ````yaml /api-reference/specs/cowork.json get /v2/workflows/evaluations openapi: 3.0.3 info: title: Youverify Cowork API version: 2.0.0 description: >- Entity, Activity, Signal, Case and Workflow Management endpoints — the core Cowork platform object model. Assembled from doc.youverify.co/api-reference-sdk, endpoints kept in the exact order they appear in the GitBook navigation. Account-wide error responses (401, 429, 500 on every endpoint; 402 on paid verification calls; 404 on lookup-by-ID calls) are sourced verbatim from Youverify's own "Youverify OS Error Codes" and "Response Codes" pages (doc.youverify.co/youverify-os-error-codes, /get-started/response-codes) and attached via components.responses, since those pages document them account-wide rather than per endpoint. Any error example that a specific endpoint's own page actually showed is kept exactly as documented there instead of being replaced by these. contact: name: Youverify Support email: support@youverify.co servers: - url: https://api.youverify.co description: Production (live, billed) - url: https://api.sandbox.youverify.co description: Sandbox (test data, not billed) security: - ApiKeyAuth: [] tags: - name: Entity Management description: >- Create, retrieve and verify entities (individuals or businesses) — the core object every check attaches to. - name: Activity Management description: Inspect the verification activities run against your account. - name: Signal Management description: Retrieve monitoring signals and their events, by entity or business. - name: Case Management description: Create and manage compliance cases, including AI-generated case summaries. - name: Workflow Management description: >- Send events to Transaction Monitoring and Customer Onboarding workflows, and read the workflows and evaluations (runs) for your business. paths: /v2/workflows/evaluations: get: tags: - Workflow Management summary: List Evaluations description: >- Lists the business's workflow runs (evaluations), cursor-paginated. Scoped to the API key's business. With no filter the list is read from MongoDB; any filter reads from Elasticsearch. operationId: listWorkflowEvaluations parameters: - name: token in: header required: true schema: type: string description: API secret token - name: workflowId in: query required: false schema: type: string description: Filter by workflow id. - name: version in: query required: false schema: type: integer description: Filter by workflow version. - name: status in: query required: false schema: type: string enum: - PENDING - RUNNING - PAUSED - SUCCESS - FAILED description: Filter by run status. - name: startDate in: query required: false schema: type: string description: Return runs from this date. - name: endDate in: query required: false schema: type: string description: Return runs up to this date. - name: eventType in: query required: false schema: type: string enum: - transaction - account_activity - onboarding description: Filter by event type. - name: eventCategory in: query required: false schema: type: string description: Filter by event category. - name: eventStatus in: query required: false schema: type: string enum: - acknowledged - pending - completed - attempted - successful - requested - issued - activated - frozen - suspended - unfrozen - pin_changed - closed - canceled - failed description: Filter by event status. - name: lifecycleId in: query required: false schema: type: string description: Filter by lifecycle id. - name: entityId in: query required: false schema: type: string description: Filter by entity id. - name: decision in: query required: false schema: type: string enum: - BLOCK - FREEZE - HOLD - REVIEW - ALERT - ALLOW description: Filter by decision. - name: limit in: query required: false schema: type: integer description: Number of records per page. - name: sortField in: query required: false schema: type: string description: Field to sort by. - name: sortOrder in: query required: false schema: type: string enum: - asc - desc description: Sort direction. - name: next in: query required: false schema: type: string description: Cursor for the next page (from `pagination.nextPage`). - name: prev in: query required: false schema: type: string description: Cursor for the previous page (from `pagination.prevPage`). responses: '200': description: Success content: application/json: schema: type: object properties: success: type: boolean statusCode: type: integer message: type: string data: type: object properties: docs: type: array items: type: object properties: id: type: string description: Evaluation id. workflowId: type: string workflowVersion: type: integer businessId: type: string parentId: type: string status: type: string enum: - PENDING - RUNNING - PAUSED - SUCCESS - FAILED createdBy: type: string createdAt: type: string format: date-time updatedAt: type: string format: date-time finishedAt: type: string format: date-time entityId: type: string entityName: type: string pagination: $ref: '#/components/schemas/WorkflowPagination' links: type: array items: type: object example: success: true statusCode: 200 message: Executions fetched successfully data: docs: - id: string workflowId: string workflowVersion: 0 businessId: string parentId: string status: PENDING createdBy: string createdAt: '2026-11-03T22:05:40.534Z' updatedAt: '2026-11-03T22:05:40.534Z' finishedAt: '2026-11-03T22:05:40.534Z' entityId: string entityName: string pagination: type: cursor perPage: 0 nextPage: string prevPage: string hasNextPage: true hasPrevPage: true totalDocs: 0 totalPages: 0 links: - {} '401': $ref: '#/components/responses/Error401Unauthorized' '429': $ref: '#/components/responses/Error429TooManyRequests' '500': $ref: '#/components/responses/Error500ServerError' components: schemas: WorkflowPagination: type: object properties: type: type: string example: cursor perPage: type: integer nextPage: type: string description: Cursor for the next page. prevPage: type: string description: Cursor for the previous page. hasNextPage: type: boolean hasPrevPage: type: boolean totalDocs: type: integer totalPages: type: integer responses: Error401Unauthorized: description: Unauthorized — the token header is missing or invalid. content: application/json: example: success: false statusCode: 401 message: Permission denied name: UnauthorizedError data: {} Error429TooManyRequests: description: Too Many Requests — you have exceeded the rate limit; wait and retry. content: application/json: example: success: false statusCode: 429 message: Too many requests name: RateLimitError data: {} Error500ServerError: description: >- Internal Server Error — a rare, unexpected failure on Youverify's side. Contact support@youverify.co if it persists. content: application/json: example: success: false statusCode: 500 message: Internal Server Error name: Error data: {} securitySchemes: ApiKeyAuth: type: apiKey in: header name: token description: Your Youverify API secret key. Never expose client-side. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.