> ## Documentation Index
> Fetch the complete documentation index at: https://docs.pathors.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get test results

> Get all run results for a test suite, newest first.



## OpenAPI

````yaml https://api.pathors.com/openapi.json get /v1/projects/{projectId}/test-suites/{testSuiteId}/results
openapi: 3.1.0
info:
  title: Pathors API
  description: >-
    Public developer API for the Pathors platform. Authenticate with a developer
    key (`Authorization: Bearer dk_...`) created from the dashboard. See
    [docs.pathors.com](https://docs.pathors.com) for guides.
  version: 1.0.0
  contact:
    name: Pathors Support
    url: https://app.pathors.com/support
servers:
  - url: https://api.pathors.com
    description: Production
  - url: http://localhost:8080
    description: Local development
security:
  - developerKey: []
tags:
  - name: Projects
    description: CRUD for projects owned by the authenticated developer
  - name: Agent Config
    description: Read and update a project's agent configuration and versions
  - name: Pathway
    description: Manage a project's pathway graph — nodes and decision edges
  - name: Chat
    description: OpenAI-compatible chat completions for a project agent
  - name: Sessions
    description: Create, search, terminate, and inspect agent sessions
  - name: Session History
    description: Browse and inspect persisted session history
  - name: Tools
    description: Manage a project's tools and inspect available tool types
  - name: Knowledgebases
    description: Manage knowledgebases and query them for relevant chunks
  - name: Datasets
    description: Upload and manage source files embedded into a knowledgebase
  - name: Test Cases
    description: CRUD for agent test cases
  - name: Test Suites
    description: Group test cases, run them, and read results
  - name: Webhooks
    description: Manage webhook subscriptions for project events
  - name: Calls
    description: Place outbound voice calls from a project agent
paths:
  /v1/projects/{projectId}/test-suites/{testSuiteId}/results:
    get:
      tags:
        - Test Suites
      summary: Get test results
      description: Get all run results for a test suite, newest first.
      operationId: getV1ProjectsByProjectIdTestSuitesByTestSuiteIdResults
      parameters:
        - name: projectId
          in: path
          required: true
          schema:
            type: string
          description: The ID of your project
        - name: testSuiteId
          in: path
          required: true
          schema:
            type: string
          description: The test suite ID
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        testSuiteId:
                          type: string
                        projectId:
                          type: string
                        name:
                          type: string
                        startedAt:
                          type: string
                          format: date-time
                          pattern: >-
                            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                        completedAt:
                          anyOf:
                            - type: string
                              format: date-time
                              pattern: >-
                                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                            - type: 'null'
                        status:
                          type: string
                          enum:
                            - RUNNING
                            - COMPLETED
                            - FAILED
                        testCaseResults:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                              testResultId:
                                type: string
                              testCaseId:
                                type: string
                              status:
                                type: string
                                enum:
                                  - PENDING
                                  - RUNNING
                                  - PASSED
                                  - FAILED
                                  - ERROR
                              messages:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                    testCaseResultId:
                                      type: string
                                    content:
                                      type: string
                                    role:
                                      type: string
                                      enum:
                                        - system
                                        - user
                                        - assistant
                                        - tool
                                        - error
                                    timestamp:
                                      type: string
                                      format: date-time
                                      pattern: >-
                                        ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
                                  required:
                                    - id
                                    - testCaseResultId
                                    - content
                                    - role
                                    - timestamp
                              criteriaResults:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    id:
                                      type: string
                                    testCaseResultId:
                                      type: string
                                    criterionId:
                                      type: string
                                    passed:
                                      type: boolean
                                    reason:
                                      anyOf:
                                        - type: string
                                        - type: 'null'
                                  required:
                                    - id
                                    - testCaseResultId
                                    - criterionId
                                    - passed
                                    - reason
                            required:
                              - id
                              - testResultId
                              - testCaseId
                              - status
                              - messages
                              - criteriaResults
                      required:
                        - id
                        - testSuiteId
                        - projectId
                        - name
                        - startedAt
                        - completedAt
                        - status
                        - testCaseResults
                required:
                  - data
        '401':
          description: Error response
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      error:
                        type: string
                    required:
                      - error
                  - type: object
                    properties:
                      error:
                        type: object
                        properties:
                          message:
                            type: string
                          code:
                            type: string
                          details:
                            type: object
                            propertyNames:
                              type: string
                            additionalProperties: {}
                        required:
                          - message
                    required:
                      - error
        '404':
          description: Error response
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      error:
                        type: string
                    required:
                      - error
                  - type: object
                    properties:
                      error:
                        type: object
                        properties:
                          message:
                            type: string
                          code:
                            type: string
                          details:
                            type: object
                            propertyNames:
                              type: string
                            additionalProperties: {}
                        required:
                          - message
                    required:
                      - error
components:
  securitySchemes:
    developerKey:
      type: http
      scheme: bearer
      bearerFormat: Developer key (dk_...)
      description: Developer key created from the dashboard (Settings → Developer Keys)

````