> ## 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. # Retrieve an Evaluation > Fetches one evaluation (execution record) by id, including its full per-node `nodeLogs`. Scoped to the API key's business. ## OpenAPI ````yaml /api-reference/specs/cowork.json get /v2/workflows/evaluations/{evaluationId} 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/{evaluationId}: get: tags: - Workflow Management summary: Retrieve an Evaluation description: >- Fetches one evaluation (execution record) by id, including its full per-node `nodeLogs`. Scoped to the API key's business. operationId: retrieveWorkflowEvaluation parameters: - name: token in: header required: true schema: type: string description: API secret token - name: evaluationId in: path required: true schema: type: string description: Unique id of the evaluation responses: '200': description: Success content: application/json: schema: type: object properties: success: type: boolean statusCode: type: integer message: type: string data: type: object properties: execution: type: object description: The execution record. properties: id: type: string workflowId: type: string workflowVersion: type: integer status: type: string enum: - PENDING - RUNNING - PAUSED - SUCCESS - FAILED nodeLogs: type: object description: Per-node logs, keyed by node id. additionalProperties: type: object description: Log of one node in the run. properties: nodeId: type: string status: type: string example: UNATTEMPTED input: type: object output: type: object error: type: string expiresAt: type: string format: date-time sla: type: object properties: policyId: type: string policyName: type: string startedAt: type: string format: date-time warnAt: type: string format: date-time dueAt: type: string format: date-time resolvedAt: type: string format: date-time state: type: string example: on_track startedAt: type: string format: date-time finishedAt: type: string format: date-time businessId: type: string parentId: type: string createdBy: type: string createdAt: type: string format: date-time updatedAt: type: string format: date-time finishedAt: type: string format: date-time workflowType: type: string enum: - CO - TM priority: type: integer entityId: type: string entityName: type: string linkedTransactionIds: type: array items: type: string linkedTransactionReferences: type: array items: type: string eventId: type: string eventType: type: string eventCategory: type: string eventStatus: type: string externalEventId: type: string lifecycleId: type: string startedAt: type: string format: date-time executionTimeMs: type: integer output: type: object properties: decision: type: string enum: - BLOCK - FREEZE - HOLD - REVIEW - ALERT - ALLOW actionReason: type: string onboarding: type: object description: >- Onboarding (CO) result; present for onboarding runs. properties: decision: type: string example: REJECTED reason: type: string entity: type: object properties: entityId: type: string entityType: type: string enum: - INDIVIDUAL - BUSINESS name: type: string risk: type: object properties: score: type: number rating: type: string example: LOW status: type: string example: PENDING documents: type: array items: type: object properties: type: type: string dateOfExpiry: type: string status: type: string example: VALID daysToExpiry: type: integer issues: type: array items: type: object properties: issueId: type: string issueType: type: string mismatchField: type: string severity: type: string status: type: string createdVia: type: string example: system checks: type: object properties: identity: type: object properties: status: type: string example: NOT_RUN business: type: object properties: status: type: string example: NOT_RUN pep: type: object properties: status: type: string example: NOT_RUN hits: type: integer sanctions: type: object properties: status: type: string example: NOT_RUN hits: type: integer screeningScore: type: number adverseMedia: type: object properties: status: type: string score: type: number actions: type: array items: type: string followUp: type: object properties: assignedQueue: type: string requiredAction: type: string alertCount: type: integer caseCreated: type: boolean failedStep: type: object properties: nodeId: type: string type: type: string error: type: string trace: type: array items: type: object properties: nodeId: type: string type: type: string status: type: string triggered: type: boolean error: type: string ruleIds: type: array items: type: string matchedRuleIds: type: array items: type: string actionsApplied: type: array items: type: string alertCount: type: integer outcome: type: object properties: result: type: string example: approved flagged: type: array items: type: string counterparties: type: array items: type: object riskScore: type: number flagged: type: boolean valueAtRisk: type: number valueAtRiskCurrency: type: string resolution: type: object properties: source: type: string example: alert outcome: type: string example: approved reference: type: string resolvedAt: type: string format: date-time detail: type: object links: type: array items: type: object example: success: true statusCode: 200 message: Execution fetched successfully data: execution: id: string workflowId: string workflowVersion: 0 status: PENDING nodeLogs: additionalProp1: nodeId: string status: UNATTEMPTED input: {} output: {} error: string expiresAt: '2026-11-03T22:08:46.092Z' sla: policyId: string policyName: string startedAt: '2026-11-03T22:08:46.092Z' warnAt: '2026-11-03T22:08:46.092Z' dueAt: '2026-11-03T22:08:46.092Z' resolvedAt: '2026-11-03T22:08:46.092Z' state: on_track startedAt: '2026-11-03T22:08:46.092Z' finishedAt: '2026-11-03T22:08:46.092Z' additionalProp2: nodeId: string status: UNATTEMPTED input: {} output: {} error: string expiresAt: '2026-11-03T22:08:46.092Z' sla: policyId: string policyName: string startedAt: '2026-11-03T22:08:46.092Z' warnAt: '2026-11-03T22:08:46.092Z' dueAt: '2026-11-03T22:08:46.092Z' resolvedAt: '2026-11-03T22:08:46.092Z' state: on_track startedAt: '2026-11-03T22:08:46.092Z' finishedAt: '2026-11-03T22:08:46.092Z' additionalProp3: nodeId: string status: UNATTEMPTED input: {} output: {} error: string expiresAt: '2026-11-03T22:08:46.092Z' sla: policyId: string policyName: string startedAt: '2026-11-03T22:08:46.092Z' warnAt: '2026-11-03T22:08:46.092Z' dueAt: '2026-11-03T22:08:46.092Z' resolvedAt: '2026-11-03T22:08:46.092Z' state: on_track startedAt: '2026-11-03T22:08:46.092Z' finishedAt: '2026-11-03T22:08:46.092Z' businessId: string parentId: string createdBy: string createdAt: '2026-11-03T22:08:46.092Z' updatedAt: '2026-11-03T22:08:46.092Z' finishedAt: '2026-11-03T22:08:46.092Z' workflowType: CO priority: 0 entityId: string entityName: string linkedTransactionIds: - string linkedTransactionReferences: - string eventId: string eventType: string eventCategory: string eventStatus: string externalEventId: string lifecycleId: string startedAt: '2026-11-03T22:08:46.092Z' executionTimeMs: 0 output: decision: BLOCK actionReason: string onboarding: decision: REJECTED reason: string entity: entityId: string entityType: INDIVIDUAL name: string risk: score: 0 rating: LOW status: PENDING documents: - type: string dateOfExpiry: string status: VALID daysToExpiry: 0 issues: - issueId: string issueType: string mismatchField: string severity: string status: string createdVia: system checks: identity: status: NOT_RUN business: status: NOT_RUN pep: status: NOT_RUN hits: 0 sanctions: status: NOT_RUN hits: 0 screeningScore: 0 adverseMedia: status: string score: 0 actions: - string followUp: assignedQueue: string requiredAction: string alertCount: 0 caseCreated: true failedStep: nodeId: string type: string error: string trace: - nodeId: string type: string status: string triggered: true error: string ruleIds: - string matchedRuleIds: - string actionsApplied: - string alertCount: 0 outcome: result: approved flagged: - string counterparties: - {} riskScore: 0 flagged: true valueAtRisk: 0 valueAtRiskCurrency: string resolution: source: alert outcome: approved reference: string resolvedAt: '2026-11-03T22:08:46.092Z' detail: {} links: - {} '401': $ref: '#/components/responses/Error401Unauthorized' '404': description: Not Found content: application/json: example: success: false statusCode: 404 message: You have attempted to get a resource that does not exist. name: ResourceNotFoundError data: {} '429': $ref: '#/components/responses/Error429TooManyRequests' '500': $ref: '#/components/responses/Error500ServerError' components: 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.