> ## 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.

# Get test taker

> Returns a test taker by id



## OpenAPI

````yaml https://api.neurapulse.com/openapi/v1.json get /projects/{projectId}/testtakers/{id}
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}/testtakers/{id}:
    get:
      tags:
        - Test Takers
      summary: Get test taker
      description: Returns a test taker by id
      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: id
          in: path
          description: The unique identifier of the test taker.
          required: true
          schema:
            pattern: ^-?(?:0|[1-9]\d*)$
            type: integer
            format: int32
      responses:
        '200':
          description: OK
          content:
            text/plain:
              schema:
                $ref: '#/components/schemas/Result'
            application/json:
              schema:
                $ref: '#/components/schemas/Result'
            text/json:
              schema:
                $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'
components:
  schemas:
    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

````