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

# List active job offers

> Returns an XML file containing company metadata and a list of all currently open job positions.



## OpenAPI

````yaml /openapi-specs/recruitment-world.yaml get /xml/{customer_subdomain}/lucca.xml
openapi: 3.1.0
info:
  title: Lucca Recruitment public APIs
  version: '1.0'
  description: >
    Welcome on the documentation for the Lucca Recruitment API (world
    endpoints).
  contact:
    name: API Support
    url: https://support.lucca.fr
    email: contact@luccasoftware.com
  license:
    name: Unlicensed
    url: https://www.luccasoftware.com
servers:
  - url: https://jobs.world.luccasoftware.com
    description: >-
      The URL of the Lucca Recruitment world endpoint. This endpoint is designed
      for

      third-party job boards and aggregators to retrieve active job offers from

      Lucca customers.


      This endpoint is publicly accessible and does not require authentication,
      but it 

      only returns job offers from companies that have explicitly opted in to
      share 

      their job data with external platforms.
security: []
tags:
  - name: Jobs
    description: Operations related to job offers and company metadata.
paths:
  /xml/{customer_subdomain}/lucca.xml:
    get:
      tags:
        - Jobs
      summary: List active job offers
      description: >-
        Returns an XML file containing company metadata and a list of all
        currently open job positions.
      operationId: list-active-job-offers
      parameters:
        - name: customer_subdomain
          in: path
          required: true
          description: >-
            The unique Lucca subdomain for the company. For instance: "example"
            if the company's Lucca URL is "https://example.ilucca.net".
          schema:
            type: string
      responses:
        '200':
          description: A structured XML feed of job offers.
          content:
            application/xml:
              schema:
                $ref: '#/components/schemas/AllJobs'
        '404':
          description: >-
            The customer subdomain was not found. Verify that the subdomain

            is correct and that the company has an active Lucca Recruitment
            account.
      security: []
components:
  schemas:
    AllJobs:
      type: object
      properties:
        CompanyName:
          type: string
          example: Lucca
          description: Legal or commercial name of the company.
        CompanyDescription:
          type: string
          description: |-
            Description of the company. Can be HTML or plain text depending
            on the customer's Lucca configuration.
          example: Lucca édite des logiciels RH.
        Offers:
          type: array
          items:
            $ref: '#/components/schemas/JobOffer'
    JobOffer:
      type: object
      properties:
        JobOpportunityId:
          type: integer
          example: 42
          description: |-
            Unique identifier for the job offer. Stable over time, can
            be used as a key for synchronization.
        Title:
          type: string
          example: Product Manager
          description: Title of the job position.
        Content:
          type: string
          description: |-
            Full job description. Can be HTML or plain text depending on
            the customer's configuration.
        ExpectedProfile:
          type: string
          description: |-
            Expected candidate profile and requirements. Can be HTML or
            plain text depending on the customer's configuration.
        Localisation:
          type: string
          example: Nantes, France
          description: City or location where the position is based.
        WorkContract:
          type: object
          description: Information about the employment contract.
          properties:
            Type:
              type: string
              example: Permanent
              description: |-
                Type of work contract (e.g. Permanent, Fixed-Term, Internship,
                Apprenticeship, etc.).
        RemunerationRange:
          type: string
          example: 38K - 41K €
          description: Indicative gross annual salary range for the position.
        Href:
          type: string
          format: uri
          description: Direct link to the job offer application form on Lucca.

````