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

# List Experience

> Returns experience entries for the candidate profile. The example response below is illustrative only.



## OpenAPI

````yaml GET /experience
openapi: 3.1.0
info:
  title: Candidate Profile API
  version: 1.0.0
  description: >-
    Personal candidate profile API published at api.jonahanderson.me. Every
    endpoint except POST /auth/token requires bearer-token authentication. All
    example payloads in this spec are illustrative and do not represent live
    data.
servers:
  - url: https://api.jonahanderson.me
    description: Production
security:
  - BearerAuth: []
tags:
  - name: Authentication
  - name: Candidate
  - name: Experience
  - name: Projects
  - name: Resume
  - name: Contact
paths:
  /experience:
    get:
      tags:
        - Experience
      summary: List experience entries
      description: >-
        Returns experience entries for the candidate profile. The example
        response below is illustrative only.
      operationId: listExperience
      parameters:
        - in: query
          name: current
          required: false
          description: Filters the response by whether the experience is current.
          schema:
            type: boolean
          examples:
            currentOnly:
              summary: Current entries only
              value: true
      responses:
        '200':
          description: Experience list.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Experience'
              examples:
                illustrativeResponse:
                  summary: Illustrative response
                  description: Sample values only. Live experience data will vary.
                  value:
                    - id: experience_example_001
                      company: Sample Systems
                      company_start_date: '2023-01-01'
                      company_end_date: null
                      current: true
                      summary: >-
                        Example summary for a current role focused on
                        integrations, platform workflows, and partner
                        enablement.
                      roles:
                        - title: Senior Product Manager
                          start_date: '2024-01-01'
                          end_date: null
                          accomplishments:
                            - >-
                              Defined an example roadmap for partner-facing API
                              improvements.
                            - >-
                              Coordinated an example cross-functional launch for
                              a workflow automation feature.
                    - id: experience_example_002
                      company: Example Labs
                      company_start_date: '2021-01-01'
                      company_end_date: '2022-12-31'
                      current: false
                      summary: >-
                        Example summary for a previous role covering customer
                        data pipelines and platform reliability.
                      roles:
                        - title: Product Manager
                          start_date: '2021-01-01'
                          end_date: '2022-12-31'
                          accomplishments:
                            - >-
                              Owned an example product area spanning ingestion,
                              partner setup, and reporting.
                            - >-
                              Delivered an example improvement to internal
                              tooling that reduced setup time.
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    Experience:
      type: object
      description: >-
        A company-level experience entry, including one or more roles held
        there.
      required:
        - id
        - company
        - company_start_date
        - current
        - summary
        - roles
      properties:
        id:
          type: string
          description: Stable identifier for the experience entry.
          example: experience_example_001
        company:
          type: string
          description: Company or organization name for the experience entry.
          example: Sample Systems
        company_start_date:
          type: string
          format: date
          description: Date when the candidate started working with the company.
          example: '2023-01-01'
        company_end_date:
          type:
            - string
            - 'null'
          format: date
          description: >-
            Date when the candidate stopped working with the company, or `null`
            if it is current.
          example: null
        current:
          type: boolean
          description: Whether this experience entry represents a current company.
          example: true
        summary:
          type: string
          description: Short summary of the work completed at the company.
          example: >-
            Example summary for a current role focused on integrations, platform
            workflows, and partner enablement.
        roles:
          type: array
          description: Roles held within this company experience.
          items:
            $ref: '#/components/schemas/ExperienceRole'
      example:
        id: experience_example_001
        company: Sample Systems
        company_start_date: '2023-01-01'
        company_end_date: null
        current: true
        summary: >-
          Example summary for a current role focused on integrations, platform
          workflows, and partner enablement.
        roles:
          - title: Senior Product Manager
            start_date: '2024-01-01'
            end_date: null
            accomplishments:
              - Defined an example roadmap for partner-facing API improvements.
              - >-
                Coordinated an example cross-functional launch for a workflow
                automation feature.
    ExperienceRole:
      type: object
      description: One role held within an experience entry.
      required:
        - title
        - start_date
        - accomplishments
      properties:
        title:
          type: string
          description: Role title held during the experience.
          example: Senior Product Manager
        start_date:
          type: string
          format: date
          description: Date when the role started.
          example: '2024-01-01'
        end_date:
          type:
            - string
            - 'null'
          format: date
          description: Date when the role ended, or `null` if it is current.
          example: null
        accomplishments:
          type: array
          description: Representative accomplishments or responsibilities for the role.
          items:
            type: string
            description: One accomplishment or responsibility.
          example:
            - Defined an example roadmap for partner-facing API improvements.
            - >-
              Coordinated an example cross-functional launch for a workflow
              automation feature.
      example:
        title: Senior Product Manager
        start_date: '2024-01-01'
        end_date: null
        accomplishments:
          - Defined an example roadmap for partner-facing API improvements.
          - >-
            Coordinated an example cross-functional launch for a workflow
            automation feature.
    ErrorResponse:
      type: object
      description: Wrapper object for API errors.
      required:
        - error
      properties:
        error:
          $ref: '#/components/schemas/Error'
      example:
        error:
          code: BAD_REQUEST
          message: The request payload is missing a required field.
    Error:
      type: object
      description: Standard error payload returned by the API.
      required:
        - code
        - message
      properties:
        code:
          type: string
          description: Machine-readable error code.
          example: BAD_REQUEST
        message:
          type: string
          description: Human-readable explanation of the error.
          example: The request payload is missing a required field.
      example:
        code: BAD_REQUEST
        message: The request payload is missing a required field.
  responses:
    BadRequest:
      description: Invalid request.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            illustrativeResponse:
              summary: Illustrative validation error
              description: Sample values only. Live error messages will vary.
              value:
                error:
                  code: BAD_REQUEST
                  message: The request payload is missing a required field.
    Unauthorized:
      description: Bearer token is missing, invalid, or altered.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            missingOrInvalidToken:
              summary: Valid bearer token required
              value:
                error:
                  code: UNAUTHORIZED
                  message: A valid bearer token is required
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Signed bearer token returned by POST /auth/token. Send it in the
        Authorization header as `Bearer <token>`.

````