Lattice Reviewees API

openapi: 3.2.0
info:
  title: Lattice Talent Reviewees API
  description: REST API for Lattice's Talent product suite covering users, departments, goals, OKRs, performance review cycles, reviewees, reviews, continuous feedback, competencies, and tags. Uses cursor-based pagination and Bearer token authentication.
  version: v1
  contact:
    name: Lattice Developer Support
    email: customercare@lattice.com
    url: https://developers.lattice.com
  termsOfService: https://lattice.com/legal/terms-of-service
  license:
    name: Proprietary
    url: https://lattice.com/legal/terms-of-service
servers:
- url: https://api.latticehq.com/v1
  description: Lattice Talent API v1 production server
security:
- BearerAuth: []
tags:
- name: Reviewees
  description: Manage reviewees within a review cycle
paths:
  /reviewCycle/{id}/reviewees:
    get:
      summary: List reviewees in a review cycle
      operationId: listReviewCycleReviewees
      tags:
      - Reviewees
      description: Returns a paginated list of all reviewees in a review cycle.
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        description: The review cycle identifier
      - $ref: '#/components/parameters/limit'
      - $ref: '#/components/parameters/startingAfter'
      responses:
        '200':
          description: Paginated list of reviewees
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RevieweeList'
        '400':
          $ref: '#/components/responses/BadRequest'
        '422':
          $ref: '#/components/responses/UnprocessableEntity'
        '500':
          $ref: '#/components/responses/ServerError'
components:
  responses:
    ServerError:
      description: Server error while processing request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    BadRequest:
      description: Invalid request parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    UnprocessableEntity:
      description: Unprocessable - request is syntactically valid but cannot be processed
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  schemas:
    RevieweeList:
      allOf:
      - $ref: '#/components/schemas/PaginatedList'
      - type: object
        properties:
          data:
            type: array
            items:
              $ref: '#/components/schemas/Reviewee'
        required:
        - data
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Human-readable error message
      required:
      - error
    WeightedScore:
      type: object
      properties:
        manual:
          type:
          - number
          - 'null'
          format: float
        autoCalculated:
          type:
          - number
          - 'null'
          format: float
    ListReference:
      type: object
      description: A reference to a paginated list of related objects
      properties:
        object:
          type: string
          enum:
          - list
        url:
          type: string
      required:
      - object
      - url
    PaginatedList:
      type: object
      properties:
        object:
          type: string
          enum:
          - list
        hasMore:
          type: boolean
          description: Whether or not there are more elements available after this set
        endingCursor:
          type:
          - string
          - 'null'
          description: The cursor to use to get the next set of items in the list
      required:
      - object
      - hasMore
    Reviewee:
      type: object
      properties:
        id:
          type: string
        object:
          type: string
        url:
          type: string
        externalUserId:
          type:
          - string
          - 'null'
        reviewCycle:
          $ref: '#/components/schemas/ObjectReference'
        user:
          $ref: '#/components/schemas/ObjectReference'
        reviews:
          $ref: '#/components/schemas/ListReference'
        revieweeFacingPDFUrl:
          type:
          - string
          - 'null'
        managerFacingPDFUrl:
          type:
          - string
          - 'null'
        closedAt:
          type:
          - integer
          - 'null'
          description: Unix timestamp when closed
        esignatureGivenAt:
          type:
          - integer
          - 'null'
          description: Unix timestamp of e-signature
        responsesReleasedAt:
          type:
          - integer
          - 'null'
          description: Unix timestamp when responses were released
        weightedScore:
          $ref: '#/components/schemas/WeightedScore'
        createdAt:
          type: integer
          description: Unix timestamp
        updatedAt:
          type: integer
          description: Unix timestamp
      required:
      - id
      - object
      - url
      - reviewCycle
      - user
      - reviews
      - createdAt
      - updatedAt
    ObjectReference:
      type: object
      description: A lightweight reference to another Lattice object
      properties:
        id:
          type: string
        object:
          type: string
        url:
          type: string
      required:
      - id
      - object
      - url
  parameters:
    limit:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        format: int32
      description: Maximum number of items to return per page
    startingAfter:
      name: startingAfter
      in: query
      required: false
      schema:
        type: string
      description: Cursor for fetching the next page of results
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: 'API key passed as a Bearer token in the Authorization header. Example: Authorization: Bearer <your-api-key>

        '