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

# List all process step changes

> Returns a paginated list of all process step changes (most recently added first)



## OpenAPI

````yaml /api-reference/openapi.json get /step
openapi: 3.0.3
info:
  title: JobAffinity REST API
  version: '1.12'
  description: >
    JobAffinity REST API for managing jobs, candidates, applications, and
    recruitment processes.


    ## Authentication

    All endpoints require HTTP Basic Authentication.


    ## Versioning

    Current version: 1.12


    See `/restapi/changelog` for version history and changes.
  contact:
    name: JobAffinity API Support
servers:
  - url: https://jobaffinity.fr/restapi/v1
    description: REST API v1
  - url: https://jobaffinity.fr/restapi
    description: REST API root (for changelog)
security:
  - basicAuth: []
tags:
  - name: API Info
    description: API metadata and changelog
  - name: Jobs
    description: Job listings and details
  - name: Candidates
    description: Candidate information
  - name: Applications
    description: Job applications
  - name: Processes
    description: Recruitment processes and steps
  - name: Notes
    description: Candidate notes
  - name: Questionnaires
    description: Questionnaire answers
  - name: Webhooks
    description: Webhook tasks
  - name: Job Application Submission
    description: >-
      Submit candidate applications to a job posting via the apply URL provided
      in the job feed. The authentication token is embedded in the URL — no
      additional credentials are required.
paths:
  /step:
    get:
      tags:
        - Processes
      summary: List all process step changes
      description: >-
        Returns a paginated list of all process step changes (most recently
        added first)
      operationId: listApplicationProcesses
      parameters:
        - $ref: '#/components/parameters/limitParam'
        - $ref: '#/components/parameters/sinceParam'
        - name: candidate_email
          in: query
          description: Filter by candidate email
          schema:
            type: string
            format: email
        - name: job_reference
          in: query
          description: Filter by job reference
          schema:
            type: string
        - name: step_status
          in: query
          description: Filter by step status
          schema:
            type: string
            enum:
              - START
              - CURRENT
              - END
        - name: step_name
          in: query
          description: Filter by step name
          schema:
            type: string
      responses:
        '200':
          description: Paginated list of step changes
          content:
            application/json:
              schema:
                type: object
                properties:
                  _self:
                    type: string
                    format: uri
                  _schema:
                    type: string
                    format: uri
                  _status:
                    type: string
                    enum:
                      - OK
                      - INVALID
                  _next:
                    type: string
                    format: uri
                    nullable: true
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/ApplicationProcess'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
components:
  parameters:
    limitParam:
      name: limit
      in: query
      description: Maximum number of items to return per page
      schema:
        type: integer
        minimum: 1
        maximum: 100
        default: 20
    sinceParam:
      name: since
      in: query
      description: Return items created or modified since this ID
      schema:
        type: integer
        minimum: 0
  schemas:
    ApplicationProcess:
      type: object
      description: A step change entry in the process history
      properties:
        change_id:
          type: integer
          description: Unique identifier for this step change
        date:
          type: string
          format: date
          description: Date of step change
        id:
          type: integer
          description: Step identifier
        name:
          type: string
          description: Step name
        status:
          type: string
          enum:
            - START
            - CURRENT
            - END
          description: Step status
        user:
          $ref: '#/components/schemas/User'
          description: User who made the step change
        application:
          type: object
          description: >-
            Full application details including candidate, job, source, and
            current step
          properties:
            _self:
              type: string
              format: uri
            id:
              type: integer
            route:
              type: string
            date:
              type: string
              format: date-time
            candidate:
              type: object
              properties:
                _self:
                  type: string
                  format: uri
                applications:
                  type: object
                  properties:
                    _self:
                      type: string
                      format: uri
                id:
                  type: integer
                title:
                  type: string
                first_name:
                  type: string
                last_name:
                  type: string
                email:
                  type: string
                  format: email
            job:
              type: object
              properties:
                _self:
                  type: string
                  format: uri
                applications:
                  type: object
                  properties:
                    _self:
                      type: string
                      format: uri
                id:
                  type: integer
                title:
                  type: string
                status:
                  type: string
            source:
              type: object
              properties:
                id:
                  type: integer
                name:
                  type: string
                posting_service:
                  type: object
                  properties:
                    id:
                      type: integer
                      nullable: true
                    name:
                      type: string
            step:
              type: object
              properties:
                name:
                  type: string
                status:
                  type: string
                id:
                  type: integer
                date:
                  type: string
                  format: date
                  nullable: true
            latest_cv_url:
              type: string
              format: uri
              nullable: true
    User:
      type: object
      properties:
        id:
          type: integer
          description: User identifier
        first_name:
          type: string
          description: First name of the user
        last_name:
          type: string
          description: Last name of the user
        email:
          type: string
          format: email
          description: Email of the user
  responses:
    UnauthorizedError:
      description: Authentication information is missing or invalid
      headers:
        WWW-Authenticate:
          schema:
            type: string
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic Authentication with API credentials

````