> ## 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 Events 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 Events Management description: >- Send events to your Transaction Monitoring (TM) and Customer Onboarding (CO) workflows, and read the workflows and evaluations (runs) for your business. paths: /v2/workflows/evaluations/{evaluationId}: get: tags: - Workflow Events 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: $ref: '#/components/schemas/Evaluation' 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: schemas: Evaluation: type: object properties: success: type: boolean example: true statusCode: type: integer enum: - 200 example: 200 message: type: string enum: - Execution fetched successfully example: Execution fetched successfully data: type: object properties: execution: type: object properties: id: type: string workflowId: type: string workflowVersion: type: integer status: type: string enum: - PENDING - RUNNING - PAUSED - SUCCESS - FAILED nodeLogs: type: object additionalProperties: type: object properties: nodeId: type: string status: type: string enum: - UNATTEMPTED - RUNNING - SUCCESS - FAILED - WAITING_FOR_EVENT - WAITING_RETRY - SKIPPED input: type: object output: type: object error: type: string nullable: true expiresAt: type: string format: date-time nullable: true sla: type: object description: >- The SLA clock of a hold or freeze; null on every other node. properties: policyId: type: string policyName: type: string startedAt: type: string format: date-time warnAt: type: string format: date-time nullable: true dueAt: type: string format: date-time resolvedAt: type: string format: date-time nullable: true state: type: string description: >- Where the clock stands at the time of the response. enum: - on_track - at_risk - breached required: - policyId - policyName - startedAt - dueAt - state startedAt: type: string format: date-time nullable: true finishedAt: type: string format: date-time nullable: true required: - nodeId - status businessId: type: string parentId: type: string nullable: true createdBy: type: string createdAt: type: string format: date-time updatedAt: type: string format: date-time finishedAt: type: string format: date-time nullable: true workflowType: type: string nullable: true enum: - CO - TM priority: type: integer entityId: type: string description: >- The entity the run is about; for a CO run with a new entity, null until it is known nullable: true entityName: type: string description: >- CO runs only: that entity's name (null until known or when it cannot be read) nullable: true linkedTransactionIds: type: array items: type: string linkedTransactionReferences: type: array items: type: string eventId: type: string nullable: true eventType: type: string nullable: true eventCategory: type: string nullable: true eventStatus: type: string nullable: true externalEventId: type: string nullable: true lifecycleId: type: string nullable: true startedAt: type: string format: date-time nullable: true executionTimeMs: type: integer nullable: true output: type: object properties: decision: type: string nullable: true enum: - BLOCK - FREEZE - HOLD - REVIEW - ALERT - ALLOW actionReason: type: string nullable: true onboarding: type: object properties: decision: type: string description: >- What the onboarding decided, from the strongest action it applied enum: - REJECTED - EDD_REQUIRED - PENDING_REVIEW - APPROVED - NO_DECISION - FAILED reason: type: string description: >- The findings that drove the decision and the action's own message nullable: true entity: type: object properties: entityId: type: string nullable: true entityType: type: string nullable: true enum: - INDIVIDUAL - BUSINESS name: type: string nullable: true risk: type: object description: >- Risk is computed after screening, so a fresh run can still report PENDING properties: score: type: number description: >- The entity's risk score (0-100); null until its risk is computed format: float nullable: true rating: type: string description: >- Band of the score: below 31 LOW, below 71 MEDIUM, else HIGH nullable: true enum: - LOW - MEDIUM - HIGH status: type: string nullable: true enum: - PENDING - IN_PROGRESS - COMPLETED documents: type: array description: Each verified identity document with its expiry { items: type: object properties: type: type: string dateOfExpiry: type: string nullable: true status: type: string enum: - VALID - EXPIRING_SOON - EXPIRED - UNKNOWN daysToExpiry: type: integer nullable: true required: - type - status issues: type: array description: >- The entity's OPEN issues from entity-consolidation-service. [] = none; null = the entity could not be read, so unknown. The compared values are not included. { items: type: object properties: issueId: type: string issueType: type: string description: >- What kind of check raised it: PII, AML or BIOMETRIC mismatchField: type: string description: >- The entity field the mismatch is about, e.g. dateOfBirth nullable: true severity: type: string nullable: true status: type: string description: Open issues only createdVia: type: string nullable: true enum: - system - manual required: - issueId - issueType - status checks: type: object properties: identity: type: object properties: status: type: string enum: - NOT_RUN - FAILED - VERIFIED - CLEARED - REVIEW_REQUIRED - NOT_CLEARED business: type: object properties: status: type: string enum: - NOT_RUN - FAILED - VERIFIED - CLEARED - REVIEW_REQUIRED - NOT_CLEARED pep: type: object properties: status: type: string enum: - NOT_RUN - FAILED - VERIFIED - CLEARED - REVIEW_REQUIRED - NOT_CLEARED hits: type: integer nullable: true sanctions: type: object properties: status: type: string enum: - NOT_RUN - FAILED - VERIFIED - CLEARED - REVIEW_REQUIRED - NOT_CLEARED hits: type: integer nullable: true screeningScore: type: number description: Highest PEP/sanctions match score (0-100) format: float nullable: true adverseMedia: type: object properties: status: type: string nullable: true score: type: number format: float nullable: true actions: type: array items: type: string followUp: type: object properties: assignedQueue: type: string nullable: true requiredAction: type: string nullable: true alertCount: type: integer caseCreated: type: boolean failedStep: type: object description: The step a failed run stopped at properties: nodeId: type: string type: type: string error: type: string nullable: true required: - nodeId - type required: - decision trace: type: array items: type: object properties: nodeId: type: string type: type: string status: type: string triggered: type: boolean error: type: string required: - nodeId - type 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 nullable: true enum: - approved - denied - manual_review - pending - no_action_defined flagged: type: array items: type: string required: - result - flagged counterparties: type: array items: type: object riskScore: type: number format: float flagged: type: boolean valueAtRisk: type: number format: float valueAtRiskCurrency: type: string nullable: true resolution: type: object properties: source: type: string enum: - alert - case outcome: type: string enum: - approved - rejected - closed reference: type: string nullable: true resolvedAt: type: string format: date-time detail: type: object required: - source - outcome - resolvedAt required: - id - workflowId - workflowVersion - status - nodeLogs - businessId - createdBy required: - execution links: type: array items: type: object required: - success - statusCode - message - data 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.