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

# Get the process steps of an application

> Returns the visible steps of the application's process, its current step, and the deduced next step of the normal flow (first visible step after the current one by rank, never an END step nor an operational step).



## OpenAPI

````yaml /api-reference/openapi.json get /application/{applicationid}/steps
openapi: 3.0.3
info:
  title: JobAffinity REST API
  version: '1.13'
  description: >
    JobAffinity REST API for managing jobs, candidates, applications, and
    recruitment processes.


    ## Authentication

    All endpoints require HTTP Basic Authentication.


    ## Versioning

    Current version: 1.13


    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: Account
    description: Authenticated user identity and organisation membership
  - 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: Templates
    description: Recorded email templates
  - 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:
  /application/{applicationid}/steps:
    get:
      tags:
        - Applications
      summary: Get the process steps of an application
      description: >-
        Returns the visible steps of the application's process, its current
        step, and the deduced next step of the normal flow (first visible step
        after the current one by rank, never an END step nor an operational
        step).
      operationId: getApplicationSteps
      parameters:
        - name: applicationid
          in: path
          required: true
          description: Application ID
          schema:
            type: integer
        - $ref: '#/components/parameters/organisationFilterParam'
      responses:
        '200':
          description: Process steps
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApplicationSteps'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
        '404':
          $ref: '#/components/responses/NotFoundError'
components:
  parameters:
    organisationFilterParam:
      name: organisation_id
      in: query
      description: >-
        Narrow the read to a single organisation. Without it, the caller keeps
        its full visibility.
      schema:
        type: integer
  schemas:
    ApplicationSteps:
      type: object
      properties:
        _status:
          type: string
          enum:
            - OK
            - INVALID
        application_id:
          type: integer
        current_step_id:
          type: integer
          nullable: true
          description: Current step, null before any step.
        steps:
          type: array
          description: Visible steps of the process, ordered by rank.
          items:
            type: object
            properties:
              id:
                type: integer
              name:
                type: string
              rank:
                type: integer
                description: Rank of the step in the process.
              status:
                type: integer
                description: 'Step status: 1 start, 2 current, 3 end.'
        next_step_id:
          type: integer
          nullable: true
          description: Deduced next step, null at the end of the flow.
        next_step_name:
          type: string
          nullable: true
        next_step_rank:
          type: integer
          nullable: true
  responses:
    UnauthorizedError:
      description: Authentication information is missing or invalid
      headers:
        WWW-Authenticate:
          schema:
            type: string
    NotFoundError:
      description: The specified resource was not found
      content:
        application/json:
          schema:
            type: object
            properties:
              _status:
                type: string
                enum:
                  - INVALID
              error:
                type: string
  securitySchemes:
    basicAuth:
      type: http
      scheme: basic
      description: HTTP Basic Authentication with API credentials

````