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

# Bulk import applications

> Creates many applications at once from a parsed CSV. Each item requires company and role. Returns the number imported. Requires authentication.



## OpenAPI

````yaml /spec.json post /applications/imports
openapi: 3.1.1
info:
  title: Reactive Resume
  version: 6.0.0
  description: >-
    Reactive Resume API. Mutations do not support Idempotency-Key. Do not
    automatically retry POST, PUT, PATCH or DELETE requests after a timeout:
    first read the resource to determine whether the operation succeeded.
    Existing enum values and response shapes are retained for compatibility.
  license:
    name: MIT
    url: https://github.com/reactive-resume/reactive-resume/blob/main/LICENSE
  contact:
    name: Amruth Pillai
    email: hello@amruthpillai.com
    url: https://amruthpillai.com
servers:
  - url: https://rxresu.me/api/openapi
security:
  - apiKey: []
  - bearerAuth: []
  - cookieAuth: []
externalDocs:
  url: https://docs.rxresu.me
  description: Reactive Resume Documentation
paths:
  /applications/imports:
    post:
      tags:
        - Applications
      summary: Bulk import applications
      description: >-
        Creates many applications at once from a parsed CSV. Each item requires
        company and role. Returns the number imported. Requires authentication.
      operationId: createApplicationImport
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                items:
                  type: array
                  minItems: 1
                  maxItems: 500
                  items:
                    type: object
                    properties:
                      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'
                      source:
                        anyOf:
                          - type: string
                          - type: 'null'
                      sourceUrl:
                        anyOf:
                          - type: string
                          - type: 'null'
                      jobDescription:
                        anyOf:
                          - type: string
                            maxLength: 20000
                          - type: 'null'
                      postingSource:
                        anyOf:
                          - type: object
                            properties:
                              method:
                                enum:
                                  - paste
                                  - builtin
                                  - firecrawl
                                  - tavily
                                  - exa
                                type: string
                              format:
                                enum:
                                  - text
                                  - markdown
                                type: string
                              requestedUrl:
                                type: string
                                format: uri
                              resolvedUrl:
                                type: string
                                format: uri
                              retrievedAt:
                                type: string
                                format: date-time
                              providerFetchedAt:
                                type: string
                                format: date-time
                              truncated:
                                type: boolean
                              completeness:
                                enum:
                                  - unknown
                                  - incomplete
                                type: string
                              fallbackReason:
                                enum:
                                  - unsafe-url
                                  - unreachable
                                  - not-a-page
                                  - too-large
                                  - auth
                                  - quota
                                  - malformed
                                  - empty
                                  - challenge
                                  - timeout
                                  - unavailable
                                  - rate-limit
                                type: string
                            required:
                              - method
                              - format
                              - truncated
                              - completeness
                          - 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: ''
                            email:
                              type: string
                              default: ''
                            phone:
                              type: string
                              default: ''
                          required:
                            - name
                      resumeId:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: The linked Reactive Resume, if any.
                      coverLetterId:
                        anyOf:
                          - type: string
                          - type: 'null'
                        description: The linked saved cover letter, if any.
                      requirements:
                        type: array
                        items:
                          type: string
                        description: >-
                          What the posting asks for, as read when the
                          application was added.
                      tags:
                        type: array
                        items:
                          type: string
                      status:
                        enum:
                          - saved
                          - applied
                          - screening
                          - interview
                          - offer
                          - closed
                        type: string
                      closedReason:
                        anyOf:
                          - enum:
                              - not-selected
                              - withdrew
                              - accepted-other
                              - no-response
                            type: string
                          - type: 'null'
                      stageEnteredAt:
                        type: string
                        pattern: ^\d{4}-\d{2}-\d{2}$
                    required:
                      - company
                      - role
              required:
                - items
      responses:
        '200':
          description: The number of applications imported.
          content:
            application/json:
              schema:
                type: object
                properties:
                  imported:
                    type: number
                required:
                  - imported
        default:
          description: >-
            Structured API error. See status and code; do not branch on message
            text.
          content:
            application/json:
              schema:
                type: object
                required:
                  - defined
                  - code
                  - status
                  - message
                properties:
                  defined:
                    type: boolean
                  code:
                    type: string
                  status:
                    type: integer
                  message:
                    type: string
                  data: {}
      security:
        - apiKey: []
        - bearerAuth: []
        - cookieAuth: []
components:
  securitySchemes:
    apiKey:
      type: apiKey
      name: x-api-key
      in: header
      description: The API key to authenticate requests.
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: An OAuth access token issued by this instance for its API/MCP resource.
    cookieAuth:
      type: apiKey
      in: cookie
      name: better-auth.session_token
      description: >-
        Browser session (secure deployments use the __Secure- prefix). Cookie
        requests must originate from this instance.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.