> ## 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 Role Evaluation Results > Returns role evaluation results for a specific campaign This endpoint returns results for campaigns with `type: "ROLE_SUBMISSION"`. ## OpenAPI ````yaml GET /v1/campaigns/role/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/role/results: get: tags: - Campaigns summary: Get campaign results description: Returns role evaluation results for a specific campaign operationId: getCampaignResults 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 - name: report_type in: query description: Type of report to generate required: false schema: type: string enum: - DETAILED - OVERALL default: OVERALL responses: '200': description: Campaign results response content: application/json: schema: oneOf: - type: object description: Response for OVERALL report type properties: data: type: array description: Array of campaign result records items: type: object properties: id: type: string format: uuid description: Unique identifier for the result record recommendation_status: type: string description: >- Recommendation status for the user (e.g., NOT_RECOMMENDED, RECOMMENDED, STRONGLY_RECOMMENDED) campaign: type: object description: Campaign information properties: id: type: string format: uuid description: >- Unique identifier of the campaign this result belongs to name: type: string description: Name of the campaign user: type: object description: User information properties: id: type: string format: uuid description: >- Unique identifier of the user who generated this result email: type: string format: email description: Email address of the user overall_score: type: number format: float description: >- User's overall proficiency score, ranging from 0 (lowest) to 5 (highest). additional_scores: type: object optional: true 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 record was created updated_at: type: string format: date-time description: >- Timestamp when the result record was last updated order_index: type: integer format: int64 description: Order index used for sorting and pagination has_more: type: boolean description: >- Indicates whether there are more results available for pagination last_record_index: type: integer format: int64 nullable: true description: >- The order index of the last record in the current page, used for pagination - type: object description: Response for DETAILED report type properties: data: type: array description: >- Array of campaign result records with detailed score information items: type: object properties: id: type: string format: uuid description: Unique identifier for the result record campaign: type: object description: Campaign information properties: id: type: string format: uuid description: >- Unique identifier of the campaign this result belongs to name: type: string description: Name of the campaign user: type: object description: User information properties: id: type: string format: uuid description: >- Unique identifier of the user who generated this result email: type: string format: email description: Email address of the user recommendation_status: type: string description: >- Recommendation status for the user (e.g., NOT_RECOMMENDED, RECOMMENDED, STRONGLY_RECOMMENDED) overall_score: type: number format: float description: >- Overall score representing the user's demonstrated proficiency level additional_scores: type: object optional: true 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 record was created updated_at: type: string format: date-time description: >- Timestamp when the result record was last updated order_index: type: integer format: int64 description: Order index used for sorting and pagination score_details: type: array description: >- Detailed score breakdown for each scenario/session items: type: object properties: id: type: string format: uuid description: >- Unique identifier for the score detail record 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 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) session: type: object description: Session information properties: id: type: string format: uuid description: Unique identifier for the session score: type: number format: float description: Overall score for this scenario eval_results: type: array description: Detailed evaluation results for each skill 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., RESOURCEFULNESS, CLIENT_EMPATHY) label: type: string description: >- Human-readable skill label (e.g., Resourcefulness, Client Empathy) 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 scenario, or null. Role submissions usually do not populate feedback. anyOf: - $ref: '#/components/schemas/Feedback' - type: 'null' created_at: type: string description: >- Timestamp when the score detail was created updated_at: type: string description: >- Timestamp when the score detail was last updated has_more: type: boolean description: >- Indicates whether there are more results available for pagination last_record_index: type: integer format: int64 nullable: true description: >- The order index of the last record in the current page, used for pagination examples: OVERALL: summary: OVERALL report type response value: data: - id: b7048779-259e-4c64-b7bf-2fb54403e936 recommendation_status: RECOMMENDED campaign: id: 5c8e2a9f-7b4d-4e1c-9a6f-3d8b5e1a7c4f name: Summer Sales Campaign 2024 user: id: 2c9d4b8a-1e5f-4a7c-9b3d-6e8f1a2c4b5d email: userZ@gmail.com overall_score: 3.37 additional_scores: cefr: score: C1 created_at: '2025-05-29T00:01:42.277Z' updated_at: '2025-04-29T00:01:42.277Z' order_index: 71747 - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 recommendation_status: STRONGLY_RECOMMENDED campaign: id: 5c8e2a9f-7b4d-4e1c-9a6f-3d8b5e1a7c4f name: Holiday Promotion 2024 user: id: 9e5a2c8f-4b1d-4e7a-8c3f-1b6d9a5e2c8f email: jane.doe@example.com overall_score: 4.2 additional_scores: {} created_at: '2025-05-28T14:30:15.123Z' updated_at: '2025-05-28T16:45:30.456Z' order_index: 71686 - id: d4e9f2a1-7b3c-4d8e-a5f6-1c2d3e4f5a6b recommendation_status: NOT_RECOMMENDED campaign: id: 5c8e2a9f-7b4d-4e1c-9a6f-3d8b5e1a7c4f name: Q4 Performance Review user: id: 0a5f53fd-5982-4390-b0a1-9c1d1ade78e7 email: john.smith@company.com overall_score: 2.38 additional_scores: cefr: score: B1 created_at: '2025-10-30T13:37:43.175Z' updated_at: '2025-10-30T13:37:43.175Z' order_index: 71680 has_more: true last_record_index: 71680 DETAILED: summary: DETAILED report type response value: data: - id: b7048779-259e-4c64-b7bf-2fb54403e936 campaign: id: 5c8e2a9f-7b4d-4e1c-9a6f-3d8b5e1a7c4f name: Summer Sales Campaign 2024 user: id: 2c9d4b8a-1e5f-4a7c-9b3d-6e8f1a2c4b5d email: userZ@gmail.com recommendation_status: RECOMMENDED overall_score: 3.37 created_at: '2025-05-29T00:01:42.277Z' updated_at: '2025-04-29T00:01:42.277Z' order_index: 29462 additional_scores: cefr: score: C1 score_details: - id: 351c9b81-9bd8-496d-b26f-e131aa00c351 user: email: userZ@gmail.com id: 2c9d4b8a-1e5f-4a7c-9b3d-6e8f1a2c4b5d scenario: id: ee376ea2-0f36-4e19-9d5e-e21478ced74a name: Planning an Event type: key: THREADED_EMAIL label: Threaded Email session: id: d27615a6-4749-4fe6-8968-98f69094ce9f score: 3.43 eval_results: - score: '3' skill: key: RESOURCEFULNESS label: Resourcefulness rationale: >- The user adequately identifies and utilizes some resources and strategies, but lacks creativity and proactive seeking of new methods, resulting in a moderate impact on efficiency. evaluated_at: '2025-04-29T05:31:42.277Z' evaluation_id: 53677334-9f8c-493e-b1a1-05cf88f567d0 feedback: null created_at: '2025-04-29T05:31:42.277' updated_at: '2025-04-29T05:31:42.277' - id: c8d9e0f1-2345-6789-abcd-ef0123456789 campaign: id: 5c8e2a9f-7b4d-4e1c-9a6f-3d8b5e1a7c4f name: Holiday Promotion 2024 user: id: 4b8d1e7a-9c5f-4a2d-8e6b-3f1c9d7a5e2b email: alice.smith@company.com recommendation_status: RECOMMENDED overall_score: 4.1 created_at: '2025-05-28T10:15:30.789Z' updated_at: '2025-05-28T12:20:45.012Z' order_index: 29464 additional_scores: cefr: score: C1 score_details: - id: 654b55ae-d652-43b3-a405-fb11656f006b user: email: alice.smith@company.com id: 4b8d1e7a-9c5f-4a2d-8e6b-3f1c9d7a5e2b scenario: id: c764f25e-7920-40d9-8984-7b0fc17d12ff name: Client Communication type: key: CHAT label: Chat session: id: c14cf74d-1a41-4e3c-9aba-5f0aff7318bf score: 4 eval_results: - score: '4' skill: key: CLIENT_EMPATHY label: Client Empathy rationale: >- The user demonstrates excellent understanding of client needs and shows strong empathy in all interactions. evaluated_at: '2025-04-28T08:45:20.123Z' evaluation_id: ef341cb3-27d7-4755-af9f-9055ab86090d feedback: null created_at: '2025-04-28T08:45:20.123' updated_at: '2025-04-28T10:30:15.456' has_more: false last_record_index: 29464 '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 ````