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

# List job applications

> Returns all job applications belonging to the authenticated user, most recently updated first. Archived applications are excluded unless includeArchived is set. Optionally filter by pipeline stage. Requires authentication.



## OpenAPI

````yaml /spec.json get /applications
openapi: 3.1.1
info:
  title: Reactive Resume
  version: 5.2.2
  description: Reactive Resume API
  license:
    name: MIT
    url: https://github.com/amruthpillai/reactive-resume/blob/main/LICENSE
  contact:
    name: Amruth Pillai
    email: hello@amruthpillai.com
    url: https://amruthpillai.com
servers:
  - url: http://localhost:3000/api/openapi
security:
  - apiKey: []
externalDocs:
  url: https://docs.rxresu.me
  description: Reactive Resume Documentation
paths:
  /applications:
    get:
      tags:
        - Applications
      summary: List job applications
      description: >-
        Returns all job applications belonging to the authenticated user, most
        recently updated first. Archived applications are excluded unless
        includeArchived is set. Optionally filter by pipeline stage. Requires
        authentication.
      operationId: listApplications
      parameters:
        - name: status
          in: query
          schema:
            enum:
              - saved
              - applied
              - screening
              - interview
              - offer
              - rejected
            type: string
          allowEmptyValue: true
          allowReserved: true
        - name: tags
          in: query
          schema:
            type: array
            items:
              type: string
          style: deepObject
          explode: true
          allowEmptyValue: true
          allowReserved: true
        - name: includeArchived
          in: query
          schema:
            type: boolean
            default: false
          allowEmptyValue: true
          allowReserved: true
      responses:
        '200':
          description: A list of the user's job applications.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      description: The ID of the application.
                    company:
                      type: string
                      minLength: 1
                      description: The company applied to.
                    role:
                      type: string
                      minLength: 1
                      description: The role / job title.
                    location:
                      anyOf:
                        - type: string
                        - type: 'null'
                    salary:
                      anyOf:
                        - type: string
                        - type: 'null'
                    status:
                      enum:
                        - saved
                        - applied
                        - screening
                        - interview
                        - offer
                        - rejected
                      type: string
                      description: The current pipeline stage.
                    archived:
                      type: boolean
                    resumeId:
                      anyOf:
                        - type: string
                        - type: 'null'
                      description: The linked Reactive Resume, if any.
                    source:
                      anyOf:
                        - type: string
                        - type: 'null'
                    tags:
                      type: array
                      items:
                        type: string
                    sourceUrl:
                      anyOf:
                        - type: string
                        - type: 'null'
                    jobDescription:
                      anyOf:
                        - type: string
                          maxLength: 20000
                        - type: 'null'
                    matchScore:
                      anyOf:
                        - type: integer
                          minimum: 0
                          maximum: 100
                        - type: 'null'
                    aiMetadata:
                      anyOf:
                        - type: object
                          propertyNames:
                            type: string
                          additionalProperties: {}
                        - type: 'null'
                    notes:
                      anyOf:
                        - type: string
                        - type: 'null'
                    resumeFileUrl:
                      anyOf:
                        - type: string
                        - type: 'null'
                    resumeFileName:
                      anyOf:
                        - type: string
                        - type: 'null'
                    coverLetterUrl:
                      anyOf:
                        - type: string
                        - type: 'null'
                    coverLetterName:
                      anyOf:
                        - type: string
                        - type: 'null'
                    followUpAt:
                      anyOf:
                        - type: string
                          format: date-time
                          x-native-type: date
                        - type: 'null'
                    followUpNote:
                      anyOf:
                        - type: string
                        - type: 'null'
                    contacts:
                      type: array
                      items:
                        type: object
                        properties:
                          name:
                            type: string
                            minLength: 1
                          role:
                            type: string
                            default: ''
                          type:
                            type: string
                            default: ''
                        required:
                          - name
                    activity:
                      type: array
                      items:
                        type: object
                        properties:
                          id:
                            type: string
                            minLength: 1
                          type:
                            enum:
                              - stage
                              - note
                              - created
                            type: string
                          text:
                            type: string
                            minLength: 1
                          at:
                            type: string
                            format: date-time
                            x-native-type: date
                        required:
                          - id
                          - type
                          - text
                          - at
                    appliedAt:
                      type: string
                      format: date-time
                      x-native-type: date
                    createdAt:
                      type: string
                      format: date-time
                      x-native-type: date
                    updatedAt:
                      type: string
                      format: date-time
                      x-native-type: date
                  required:
                    - id
                    - company
                    - role
                    - location
                    - salary
                    - status
                    - archived
                    - resumeId
                    - source
                    - tags
                    - sourceUrl
                    - jobDescription
                    - matchScore
                    - aiMetadata
                    - notes
                    - resumeFileUrl
                    - resumeFileName
                    - coverLetterUrl
                    - coverLetterName
                    - followUpAt
                    - followUpNote
                    - contacts
                    - activity
                    - appliedAt
                    - createdAt
                    - updatedAt
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header
      description: The API key to authenticate requests.

````