GET : Job applications

This endpoint lets you retrieve all job applications for a given job, company or media.

This endpoint requires:

• media_admin or brand_admin roles

• r_candidates scope

Media opened job applications

GET https://api-piloty.fr/opportunities

Query Parameters

Name	Type	Description
media-public-id*	String	Public id of the media
company-public-id	String	Public id of a company
job-public-id	String	Public id of a job
limit	Number	Amount of items per page (default=500)
next-page	String	Cursor to definition. See Pagination

Response examples

200: OK success

Request

https://api-piloty.fr/opportunities?limit=5&media-public-id=[authorized_media]

Response

{
    "total": 121,
    "totalPages": 13,
    "next-page":"CIMjGgIQABoJKaZ3asmVAQAAIho6GDY3ZTFhNDc4ZTc0ODNjMWI0ZDUyOWE0Yg=="
    "opportunities": [
        {
             "company": {
                "public_id": "acme",
                "name": "Acme"
            },
            "job": {
                "public_id": "graphiste",
                "name": "Graphiste"
            },
            "candidate": {
                "public_id": "gaC47OAyPhEa",
                "fullname": "John Doe",
                "email": "[e-mail]"
            },
            "infos": {
                "comment": "Lorem Ipsum ....",
                "resume":
                "questions": []
            },
            "process": [
                {
                    "state": "apply",
                    "job_public_id": "graphiste",
                    "comment": "application",
                    "date": "2024-07-04T11:51:32.401Z"
                }
            ],
            "createdAt": "2024-07-04T11:51:32.404Z"
        },
        { ... },
    ]
}

401: Unauthorized unauthorized limitation

Request

https://api-piloty.fr/opportunities?media-public-id=[unauthorized_media]

Response

{
    "status": 401,
    "error": "unauthorized-limitation"
}

400: Bad request missing media-public-id

Request

https://api-piloty.fr/opportunities

Response

{
    "status": 400,
    "error": "missing-media-public-id"
}

Request example

curl    -X GET -G "https://api-piloty.fr/opportunities?media-public-id=acme_media \
        -H "Authorization: Bearer PILOTY_TOKEN"