Jobifyre API Documentation

Access job offers and candidate submissions through our powerful REST API.

Job Offers API

List All Job Offers

Retrieve a list of all active job offers.

GET /joboffers

Returns a list of job offers with pagination support.

Query Parameters

Parameter	Type	Required	Description
status	string	No	Filter by job status (DRAFT, NEW, PUBLISHED, HIDDEN, ARCHIVED)
isDisplayed	boolean	No	Filter displayed jobs only

Response Example (200 OK)

JSON

{
"success": true,
"count": 1,
  "data": [
    {
        "createdBy": {
            "userref": "URE-89XYZ",
            "firstname": "Alice",
            "lastname": "Bob",
            "username": "useralicename",
            "email": "useraliceemail@ex.co",
            "isActive": true,
            "lastLogin": "2025-12-01T20:13:44+01:00",
            "createdAt": "2025-12-01T21:29:36+02:00"
        },
        "category": "Choosen category",
        "ref": "xxxx-xxxx-xxxx",
        "title": "Job Offer title",
        "post": "Job Offer post",
        "description": "This your job offer description in HTML format",
        "coverImage": "/url/to/cover/image",
        "metaDescription": "metaDescription",
        "metaImage": "/url/to/meta/image",
        "country": "Switzerland",
        "location": "Genève",
        "workType": "REMOTE", #ff
        "contractType": "CDI",
        "minExperience": 0,
        "maxExperience": 11,
        "salary": "2000 USD - 4000 USD",
        "vacancy": 3,
        "department": "DINA-IT",
        "status": "HIDDEN",
        "isDisplayed": true,
        "publishedAt": "2025-09-18T15:14:21+02:00",
        "createdAt": "2025-08-09T19:30:05+02:00"
    }
  ]
}

Get Job Offer Details

Retrieve detailed information about a specific job offer.

GET /joboffers/get/{ref}

Returns complete details for a single job offer.

Path Parameters

Parameter	Type	Required	Description
ref	string	Yes	Unique job offer identifier