> ## Documentation Index > Fetch the complete documentation index at: https://docs.hirednow.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Session Evaluation Results > Returns session evaluation results for a specific campaign with detailed scoring and evaluations This endpoint returns results for campaigns with `type: "SESSION_COMPLETION"`. ## OpenAPI ````yaml GET /v1/campaigns/session/results openapi: 3.1.0 info: title: HiredNow External API description: Customer-facing API for retrieving campaign evaluation results. license: name: MIT version: 1.0.0 servers: - url: https://api.external.hirednow.ai security: - bearerAuth: [] paths: /v1/campaigns/session/results: get: tags: - Campaigns summary: List session evaluation results description: >- Returns session evaluation results for a specific campaign with detailed scoring and evaluations operationId: listSessionEvaluationResults parameters: - name: campaign_id in: query description: Unique identifier for the campaign required: true schema: type: string format: uuid - name: limit in: query description: Number of results to return required: false schema: type: integer minimum: 1 maximum: 100 default: 10 - name: sort in: query description: Sort order for the results required: false schema: type: string enum: - desc - asc default: desc - name: start_date in: query description: Start date for filtering results (YYYY-MM-DD format) required: false schema: type: string format: date pattern: ^\d{4}-\d{2}-\d{2}$ - name: end_date in: query description: End date for filtering results (YYYY-MM-DD format) required: false schema: type: string format: date pattern: ^\d{4}-\d{2}-\d{2}$ - name: starting_after in: query description: Pagination cursor - results after this big integer value required: false schema: type: integer format: int64 responses: '200': description: Session evaluation results response content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string format: uuid description: Unique identifier for the evaluation result score: type: number format: float description: Overall score for the scenario campaign: type: object description: Campaign information properties: id: type: string format: uuid description: Unique identifier of the campaign name: type: string description: Name of the campaign user: type: object description: User information properties: email: type: string format: email description: Email address of the user id: type: string format: uuid description: Unique identifier of the user session: type: object description: Session information properties: id: type: string format: uuid description: Unique identifier for the session scenario: type: object description: Scenario information properties: id: type: string format: uuid description: Unique identifier of the scenario name: type: string description: Name of the scenario that was evaluated type: type: object description: Type of scenario with key and label properties: key: type: string description: >- Scenario type key (e.g., EMAIL, CHAT, THREADED_EMAIL) label: type: string description: >- Human-readable scenario type label (e.g., Email, Chat, Threaded Email) eval_results: type: array description: Detailed evaluation results for each skill assessed items: type: object properties: score: type: string description: Score for this specific skill skill: type: object description: Skill being evaluated with key and label properties: key: type: string description: >- Skill key (e.g., JUDGMENT, ATTENTION_TO_DETAIL, PRIORITIZATION) label: type: string description: >- Human-readable skill label (e.g., Judgment, Attention to Detail, Prioritization) rationale: type: string description: Detailed rationale for the score evaluated_at: type: string format: date-time description: Timestamp when the evaluation was performed evaluation_id: type: string format: uuid description: Unique identifier for this evaluation feedback: description: Structured feedback for this session, or null. anyOf: - $ref: '#/components/schemas/Feedback' - type: 'null' additional_scores: type: object nullable: true description: Additional scoring metrics and assessments properties: cefr: type: object description: >- CEFR (Common European Framework of Reference for Languages) assessment properties: score: type: string description: CEFR level (e.g., A1, A2, B1, B2, C1, C2) created_at: type: string format: date-time description: Timestamp when the result was created updated_at: type: string format: date-time description: Timestamp when the result was last updated order_index: type: integer format: int64 description: Order index used for sorting has_more: type: boolean description: Whether more results are available for pagination last_record_index: type: integer format: int64 nullable: true description: >- order_index of the last record in this page, used as the next starting_after cursor example: data: - id: f04352f1-2452-4cb7-8bad-56d6a089d56a score: 3.2 campaign: id: 5c8e2a9f-7b4d-4e1c-9a6f-3d8b5e1a7c4f name: Summer Sales Campaign 2024 user: email: john.smith@example.com id: 7a3f8e12-9b4d-4c7a-8f1e-2d6b5c8a9e3f session: id: 8395386a-a15f-44cd-acca-84d51cef5aaf scenario: id: c764f25e-7920-40d9-8984-7b0fc17d12ff name: Inbox Triage type: key: EMAIL label: Threaded Email eval_results: - score: '3' skill: key: JUDGMENT label: Judgment evaluated_at: '2025-04-29T00:01:42.277Z' evaluation_id: c204d8dd-8550-4c39-bf2c-23c11c090932 rationale: >- The candidate makes reasonable decisions in straightforward situations but struggles with uncertainty, as seen in the inappropriate response to the CEO's complaint and ignoring the vague project email. - score: '3' skill: key: ATTENTION_TO_DETAIL label: Attention to Detail evaluated_at: '2025-04-29T00:01:42.277Z' evaluation_id: c204d8dd-8550-4c39-bf2c-23c11c090932 rationale: >- The candidate demonstrates acceptable accuracy but misses some details, such as responding as Alex inappropriately and ignoring a request for guidance, indicating a need for occasional corrections. - score: '4' skill: key: PRIORITIZATION label: Prioritization evaluated_at: '2025-04-29T00:01:42.277Z' evaluation_id: c204d8dd-8550-4c39-bf2c-23c11c090932 rationale: >- The candidate effectively prioritizes high-impact tasks, such as urgent investor presentation changes and confidential merger details, while also addressing routine matters, demonstrating proficient prioritization skills. - score: '3' skill: key: WRITTEN_COMMUNICATION label: Written Communication evaluated_at: '2025-04-29T00:01:42.277Z' evaluation_id: c204d8dd-8550-4c39-bf2c-23c11c090932 rationale: >- The candidate communicates with occasional errors and lapses in clarity, such as in the reasoning for Email Response Pair #1 and #5, but generally conveys the intended message. The responses show some tailoring to the audience, but there are instances of misjudgment, such as replying as the client in Email Response Pair #3, which affects professionalism. - score: '3' skill: key: CRITICAL_THINKING label: Critical Thinking evaluated_at: '2025-04-29T00:01:42.277Z' evaluation_id: c204d8dd-8550-4c39-bf2c-23c11c090932 rationale: >- The user demonstrates basic logical reasoning skills and attempts to evaluate information, but their responses often lack depth and consideration of multiple perspectives, such as ignoring the Project Phoenix email. feedback: strengths: - description: >- You made an attempt to communicate, which is a foundational step in engaging with tasks. - description: >- Your initial response indicates a willingness to participate. growths: - description: >- Structure your responses with a clear, logical flow so your communication is easy to follow. improvement_criteria: - skill: WRITTEN_COMMUNICATION title: State the point upfront description: >- Lead with the core message, then add supporting detail, so the reader grasps your intent immediately. cross_attempts_feedback: null additional_scores: cefr: score: C1 created_at: '2025-04-29T00:01:42.277Z' updated_at: '2025-04-29T00:01:42.277Z' order_index: 4 - id: a1f85a36-46b9-426b-9ffb-43cfa12e9874 score: 2 campaign: id: 5c8e2a9f-7b4d-4e1c-9a6f-3d8b5e1a7c4f name: Summer Sales Campaign 2024 user: email: jane.doe@example.com id: 5a500af8-3668-4206-b43b-a00840b15a88 session: id: 6ab6e9e2-7095-475d-bc03-a7ebe905e2ad scenario: id: 30cc807d-f1a4-4bf3-9ae3-e1fe952da044 name: The safety observation (Voice) type: key: VOICE_CHAT label: Voice eval_results: - score: '2' skill: key: COMMUNICATION label: Communication evaluated_at: '2025-04-30T00:01:42.277Z' evaluation_id: f21f1351-cd18-4f6a-afbb-3aaa78d2b96b rationale: >- The user raised the concern but lacked clarity and did not drive the conversation to a concrete next step. - score: '2' skill: key: SAFETY_AWARENESS label: Safety Awareness evaluated_at: '2025-04-30T00:01:42.277Z' evaluation_id: f21f1351-cd18-4f6a-afbb-3aaa78d2b96b rationale: >- The user identified the hazard but did not maintain the concern under pushback, leaving it unresolved. feedback: strengths: - description: >- You took the initiative to report a potential safety hazard to your supervisor. growths: - description: >- When the issue was dismissed, you accepted it. Next time, propose a concrete next step to keep the hazard from going unaddressed. improvement_criteria: - skill: SAFETY_AWARENESS title: Re-anchor on the specific risk description: >- If the concern is dismissed, re-center on the danger: its location at a busy crossing makes it a serious slip hazard. cross_attempts_feedback: description: >- Across attempts, your hazard identification is consistent, but driving the conversation to a concrete resolution remains an area to focus on. additional_scores: null created_at: '2025-04-30T00:01:42.277Z' updated_at: '2025-04-30T00:01:42.277Z' order_index: 3 has_more: false last_record_index: 3 '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' example: error: message: Unauthorized status_code: 401 request_id: 3a6e9741-268b-41a7-b924-5fa7019e6f26 '404': description: Campaign not found content: application/json: schema: $ref: '#/components/schemas/Error' example: error: message: Not found status_code: 404 request_id: 8b2d4e7a-1c9f-4a3d-9e6b-5f8c2a7d1e4b components: schemas: Feedback: type: object description: Structured, customer-facing feedback for an evaluation. properties: strengths: type: array description: Things the candidate did well. items: type: object properties: description: type: string description: Description of the strength growths: type: array description: Areas where the candidate can improve. items: type: object properties: description: type: string description: Description of the growth area improvement_criteria: type: array description: Actionable, skill-tagged improvement guidance. items: type: object properties: skill: type: string description: Skill key the criterion relates to title: type: string description: Short title for the improvement criterion description: type: string description: Detailed improvement guidance cross_attempts_feedback: type: object nullable: true description: >- Feedback synthesized across multiple attempts, or null when not applicable. properties: description: type: string description: Cross-attempt feedback text Error: type: object properties: error: type: object required: - message - status_code - request_id properties: message: type: string description: Human-readable error message status_code: type: integer format: int32 description: HTTP status code request_id: type: string format: uuid description: Unique identifier for the request, useful for debugging securitySchemes: bearerAuth: type: http scheme: bearer ````