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

# List latest results

> Returns a paginated list of each test taker's latest result in the project. Filter by referenceId, fullName, or email.



## OpenAPI

````yaml https://api.neurapulse.com/openapi/v1.json get /projects/{projectId}/results
openapi: 3.1.1
info:
  title: api-service | v1
  version: 1.0.0
servers:
  - url: https://api.neurapulse.com
security:
  - ApiKey: []
tags:
  - name: Project Results
  - name: Projects
  - name: Test Takers
  - name: Workspace
paths:
  /projects/{projectId}/results:
    get:
      tags:
        - Project Results
      summary: List latest results
      description: >-
        Returns a paginated list of each test taker's latest result in the
        project. Filter by referenceId, fullName, or email.
      parameters:
        - name: projectId
          in: path
          description: Project Id. Obtain via GET /projects or from the project URL.
          required: true
          schema:
            type: string
            format: uuid
        - name: page
          in: query
          description: 'Page number, starting at 1. Default: 1.'
          schema:
            pattern: ^-?(?:0|[1-9]\d*)$
            type:
              - integer
              - string
            format: int32
            default: 1
        - name: pageSize
          in: query
          description: 'Items per page (1–100). Default: 100.'
          schema:
            pattern: ^-?(?:0|[1-9]\d*)$
            type:
              - integer
              - string
            format: int32
            default: 100
        - name: order
          in: query
          description: 'Sort direction. One of: asc, desc. Default: asc.'
          schema:
            $ref: '#/components/schemas/OrderByType'
            default: Desc
        - name: orderBy
          in: query
          description: >-
            Sort field. One of: priority, performance, fullName, lastTestSent.
            Default: priority.
          schema:
            $ref: '#/components/schemas/ResultOrderByType'
            default: Priority
        - name: filter
          in: query
          description: Substring match across referenceId, fullName, and email.
          schema:
            maxLength: 500
            type: string
            default: ''
        - name: completedOnly
          in: query
          description: Only retrieve test takers that have completed their test.
          schema:
            type: boolean
        - name: hasReferenceId
          in: query
          description: Only retrieve results that do or do not have a reference id.
          schema:
            type: boolean
        - name: hasLastTestSent
          in: query
          description: >-
            Filter by presence of LastTestSentUtc. true = has value, false = no
            value, null = all.
          schema:
            type: boolean
        - name: lastTestSentFromUtc
          in: query
          description: Lower bound (inclusive) for LastTestSentUtc. ISO 8601.
          schema:
            type: string
            format: date-time
        - name: lastTestSentToUtc
          in: query
          description: Upper bound (inclusive) for LastTestSentUtc. ISO 8601.
          schema:
            type: string
            format: date-time
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Result'
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Result'
            text/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Result'
        '400':
          description: Bad Request
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '401':
          description: Unauthorized
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '403':
          description: Forbidden
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '404':
          description: Not Found
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
            text/json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      deprecated: true
components:
  schemas:
    OrderByType:
      enum:
        - Asc
        - Desc
      type: string
      example: Asc
    ResultOrderByType:
      enum:
        - Priority
        - Performance
        - FullName
        - LastTestSent
      type: string
      example: Priority
    Result:
      required:
        - id
        - email
      type: object
      properties:
        id:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - integer
            - string
          description: Numeric identifier of the test taker within the project.
          format: int32
        referenceId:
          type:
            - 'null'
            - string
          description: >-
            Your own identifier for this test taker, echoed back if one was
            supplied on creation. Null if none was set.
        email:
          type: string
          description: The test taker's email address.
        firstName:
          type:
            - 'null'
            - string
          description: The test taker's first name. Null if not provided.
        lastName:
          type:
            - 'null'
            - string
          description: The test taker's last name. Null if not provided.
        fullName:
          type: string
          description: >-
            The test taker's full name (first and last combined). Empty string
            if no name is on file.
        yearOfBirth:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - 'null'
            - integer
            - string
          description: The test taker's year of birth. Null if not provided.
          format: int32
        result:
          oneOf:
            - type: 'null'
            - $ref: '#/components/schemas/TestCompletionStatusType'
              description: >-
                Latest assessment status for this test taker. Null if they have
                not started a test yet.
        dateCompleted:
          type:
            - 'null'
            - string
          description: >-
            When the test taker's most recent assessment was completed
            (ISO-8601, UTC). Null if no assessment has been completed.
          format: date-time
        lastTestSentUtc:
          type:
            - 'null'
            - string
          description: >-
            When the most recent test invitation was sent to this test taker
            (ISO-8601, UTC). Null if a test has never been sent.
          format: date-time
        topPerformer:
          type: boolean
          description: >-
            Whether this test taker is flagged as a top performer for the
            project. A derived categorical indicator, not a score or ranking.
    ProblemDetails:
      type: object
      properties:
        type:
          type:
            - 'null'
            - string
          description: >-
            A URI reference identifying the problem type (RFC 7807). Null when
            no specific type is assigned.
        title:
          type:
            - 'null'
            - string
          description: A short, human-readable summary of the problem type.
        status:
          pattern: ^-?(?:0|[1-9]\d*)$
          type:
            - 'null'
            - integer
            - string
          description: >-
            The HTTP status code for this problem, duplicated in the body for
            convenience.
          format: int32
        detail:
          type:
            - 'null'
            - string
          description: >-
            A human-readable explanation specific to this occurrence of the
            problem.
        instance:
          type:
            - 'null'
            - string
          description: >-
            A URI reference identifying the specific occurrence of the problem
            (typically the request path).
    TestCompletionStatusType:
      enum:
        - Started
        - Completed
        - CouldNotCompleteConnectionIssues
        - CouldNotCompleteNpServerIssues
        - CouldNotCompleteTimedOut
        - CouldNotCompleteUnsupportedDevice
        - Confirming
        - HighRisk
        - InProgress
        - NotStarted
        - Incomplete
        - Fatigued
        - Distressed
        - ReasonableCause
        - Escalated
        - Emergency
        - null
      type: string
      example: Started
  securitySchemes:
    ApiKey:
      type: apiKey
      description: API key generated in the Portal (Workspace Settings → API Keys).
      name: x-api-key
      in: header

````