Piloty API
  • Introduction
  • 🔓Authentication
  • 🔭Scopes and Roles
  • ⏲️Rate limits
  • 📂Pagination
  • ⁉️Errors and Status
  • 🏢COMPANIES API
    • Companies
      • GET : Companies by media
      • GET : Retrieve Company
      • POST : Create company
      • PATCH : Update company
    • Company 's fields
      • GET : List Sectors
      • GET : List Sizes
  • 💼JOBS API
    • Jobs
      • GET : Jobs by media
      • GET : Retrieve job
      • GET : Jobs opened by media
      • GET : Retrieve job opened
      • POST : Create job
      • PATCH : Update job
    • Job's fields
      • GET : List Contracts
      • GET : List Experiences
      • GET : List Educations
      • GET : List Remote policies
      • GET : List Worktimes
      • GET : List Job Categories
  • 👤USERS API
    • Users
      • GET : Users by media
  • 🧑‍💼CANDIDATES API
    • Candidates
      • GET : User candidates by media
      • GET : Job alerts
      • GET : Favoris
    • Opportunities
      • POST : Job applications - v2
      • GET : Job applications
      • 🛑Deprecated - POST : Job applications - v1
  • 📕Changelog
Powered by GitBook
On this page
  1. JOBS API
  2. Jobs

GET : Retrieve job

This endpoint lets you retrieve one job for a given public Id.

This endpoint requires :

• brand_admin, media_admin or media_partner roles.

• r_jobs scope.

Job info

GET https://api-piloty.fr/jobs/:job-public-id

Important fields

• public_id : Unique identifier of the job

• apply_url : Candidate's redirection URL for applying

• is_redirect_apply : Candidate's application is outside of Piloty

• questions : List of application questions

Path Parameters

Name
Type
Description

job-public-id*

String

Public id of the job

[
    
        {
            "name": "Opérateur régleur (H/F)",
            "public_id": "operateur-regleur-h-f-7",
            "company": {
                "public_id": "acme",
                "name": "ACME"
            },
            "worktime": {
                "public_id": "fulltime",
                "name": "Temps plein"
            },
            "remote": {
                "public_id": "never",
                "name": "Pas de télétravail"
            },
            "education": {
                "public_id": "a_level_pro",
                "name": "BAC professionnel"
            },
            "experience": {
                "public_id": "more_than_5_years",
                "name": "> 5 ans"
            },
            "contract": {
                "public_id": "interim",
                "name": "Intérim"
            },
            "office": {
                "public_id": "ymMDEOERPEqM",
                "name": "Lille"
            },
            "location": {
                "address_nbr": null,
                "address": null,
                "city": "Lille",
                "administrative_area_department": "Nord",
                "administrative_area_region": "Hauts-de-France",
                "zip_code": "59260",
                "country": "France",
                "country_code": "FRA"
            },
            "salary": "2 000€ à 2 800€ / mois",
            "description": {
                "company_desc": "<p><strong>Champagne Veuve Clicquot</strong></p><p><strong><em>Depuis sa création en 1772, la Maison Veuve Clicquot Ponsardin élabore de grands vins de Champagne et exporte aujourd’hui plus de 90% de ses vins hors de France, dans plus de 150 pays. Reconnaissable partout dans le monde grâce à sa fameuse couleur « Jaune Clicquot », la Maison se distingue par sa capacité à innover et étonner grâce à la « Clicquot touch » et à sa devise « Une seule qualité, la toute première » !</em></strong></p><p><strong><em>Nous renforçons nos équipes et souhaitons intégrer :</em></strong></p>",
                "job_desc": "<p><strong>Vigneron Qualifié F/H</strong></p><p><strong>Conduite enjambeurs exigée</strong></p>",
                "profile_desc": "<p>Titulaire du Certificat de Taille, vous possédez un BTA, un Bac Pro ou un niveau équivalent.</p><p></p><p>Vous justifiez de 5 ans minimum d'expérience et maîtrisez la conduite des tracteurs enjambeurs (test de conduite mené dans le processus de recrutement).</p><p></p><p>Vous êtes réactif, doté d'un bon relationnel et vous vous épanouissez dans le travail en équipe.</p>",
                "benefit_desc": "<p>Poste en CDI  - à temps complet</p>",
                "process_desc": "<p><strong>Adressez-nous votre candidature en précisant l’intitulé du poste à :</strong></p><p><strong>Veuve Clicquot - Service Ressources Humaines -12, rue du Temple - 51100 REIMS</strong></p><p></p><p><strong>ou par mail : recrutement@moethennessy.com</strong></p><p></p><p><strong>www.veuve-clicquot.fr</strong></p>"
            },
            "questions": [
                {
                    "_id": "62860f2872f9aba0dcbb31ec",
                    "name": "Firstname",
                    "ref": "firstname",
                    "ref_type": "string",
                    "title": {
                        "en": "First name:",
                        "fr": "Prénom"
                    },
                    "placeholder": {
                        "en": "Your First name",
                        "fr": "Votre Prénom"
                    },
                    "is_required": true
                },
                {
                    "_id": "62860f7d72f9aba0dcbb4a12",
                    "name": "Lastname",
                    "ref": "lastname",
                    "ref_type": "string",
                    "title": {
                        "en": "Last name",
                        "fr": "Nom"
                    },
                    "placeholder": {
                        "en": "Your Last name",
                        "fr": "Votre Nom"
                    },
                    "is_required": true
                },
                {
                    "_id": "62860eb872f9aba0dcbb17cd",
                    "ref": "email",
                    "name": "Email",
                    "ref_type": "email",
                    "title": {
                        "en": "Email",
                        "fr": "Adresse email"
                    },
                    "is_required": true
                },
                {
                    "_id": "62860ee372f9aba0dcbb21ba",
                    "name": "Phone number",
                    "ref": "phone_number",
                    "ref_type": "phone_number",
                    "title": {
                        "en": "Phone number",
                        "fr": "Numéro de téléphone"
                    },
                    "placeholder": {
                        "en": "Your phone number",
                        "fr": "Votre Numéro de téléphone"
                    },
                    "is_required": false
                },
                {
                    "_id": "62860d6672f9aba0dcbac1f7",
                    "name": "Comment",
                    "ref": "comment",
                    "ref_type": "string",
                    "title": {
                        "en": "Share your motivation with us",
                        "fr": "Partagez-nous votre motivation"
                    },
                    "placeholder": {
                        "en": "Make them want to hire you! NB: this message will only be shared with the recruitment team .",
                        "fr": "Donnez-leur envie de vous recruter ! NB : ce message ne leur sera transmis qu'à la team recrutement."
                    },
                    "is_required": true
                },
                {
                    "_id": "6286104a72f9aba0dcbb8271",
                    "name": "Resume",
                    "ref": "resume",
                    "ref_type": "url",
                    "title": {
                        "en": "Resume",
                        "fr": "CV"
                    },
                    "placeholder": {
                        "en": "Upload my resume",
                        "fr": "Importer un fichier"
                    },
                    "is_required": true
                }
            ],
            "job_url": "https://jobs.piloty.fr/entreprises/acme/offres/acme-operateur-regleur-h-f-7",
            "apply_url": "https://jobs.piloty.fr/entreprises/acme/offres/acme-operateur-regleur-h-f-7?apply=true",
            "publishedAt": "2024-02-02T12:32:20.339Z",
            "is_redirect_apply": false
        }
]
{
    "status": 401,
    "error": "unauthorized-limitation",
    "errorMessage": "Unauthorized"
}
{
    "status": 400,
    "error": "job-not-published",
    "errorMessage": "Bad Request"
}

Request example

curl -X GET -G "https://api-piloty.fr/jobs/opened/:job-public-id" \
    -H "Authorization: Bearer PILOTY_TOKEN" \
PreviousGET : Jobs by mediaNextGET : Jobs opened by media

Last updated 1 month ago

💼