Developer Documentation: Job API

Base Url:

https://www.voceer.com/api/v1

www.voceer.com is now the default url for UK job postings. The uk.voceer.com url will still be available but job postings will be refreshed hourly.

Authentication

To use the Job Posting API, you must first authenticate to obtain a token. Use the `/login` endpoint with your credentials to receive a bearer token. Include this token in the `Authorization` header of subsequent requests.

Tokens expire after 3 days, please ensure you re-auth for each session.

POST /login
Headers: Content-Type: application/json
Body: { "email": "your_email", "password": "your_password" }

Response will contain the token: `{ "token": "your_bearer_token" }`

Get Company Job List

With the token obtained from authentication, you can now get your company jobs using the `/company-jobs` endpoint.

GET /company-jobs
Headers: 
    Authorization: Bearer your_bearer_token
    Content-Type: application/json

Posting a Job

With the token obtained from authentication, you can now post a job using the `/company-jobs` endpoint.

POST /company-jobs
Headers: 
    Authorization: Bearer your_bearer_token
    Content-Type: application/json
Body:
{
    "job_title": "Senior Developer",
    ...
}

Updating a Job

With the token obtained from authentication, you can now update a job using the `/company-jobs` endpoint.

PUT /company-jobs/{ job-id }
Headers: 
    Authorization: Bearer your_bearer_token
    Content-Type: application/json
Body:
{
    "job_title": "Senior Developer",
    ...
}

Deleting a Job

With the token obtained from authentication, you can now delete a job using the `/company-jobs` endpoint.

DELETE /company-jobs/{ job-id }
Headers: 
    Authorization: Bearer your_bearer_token
    Content-Type: application/json
Body:
{
    "job_title": "Senior Developer",
    ...
}

Validation Rules

Each field in the job posting request has specific validation rules:

job_title: Required, string, max length of 255 characters.
description: Required, string, max length of 50000 characters.
salary_min: Required, numeric, max length of 25 characters.
salary_max: Required, numeric, max length of 25 characters.
salary_type: Required, string. Possible Values
- per-hour: Salary type displayed is per hour.
- per-day: Salary type displayed is per day.
- per-annum: Salary type displayed is per annum.
currency: Required, string. Possible Values
- GBP
- USD
- EUR
- AUD
- CAD
country: Required, string, max length of 255 characters.
location: Required, string, max length of 255 characters.
postcode: (Required for United Kingdom only), string, max length of 10 characters.
send_to: string, max length of 255 characters.
apply_website: string, max length of 255 characters.
display_salary: string.
salary_options: string. Possible Values
- negotiable
- commission
- competative
remote: Boolean.
uk_worker: Boolean.
student_eligibility: Boolean.
public_sector: Boolean.
benefits_salary: Boolean.
ote_salary: Boolean.
prorata_salary: Boolean.
negotiable_salary: Boolean.
coverletter_required: Boolean. Possible Values
- yes
- no
- optional
reference_number: string, max length of 255 characters.
contract_type: Required, string. Possible Values
- permanent
- contract
- temporary
employment_hours: Required, string. Possible Values
- full-time
- part-time
- both
work_from_home: Boolean.
sector: Required, string. Possible Values
- Education
- Engineering
- IT & Telecoms
- Accountancy
- Construction & Property
- Accountancy (Qualified)
- Admin, Secretarial & PA
- Legal
- Sales
- Retail
- Social Care
- Transport & Logistics
- Health & Medicine
- Financial Services
- Recruitment Consultancy
- Customer Service
- Estate Agency
- Manufacturing
- Marketing & PR
- Motoring & Automotive
- Human Resources
- General Insurance
- Hospitality & Catering
- Other
- Banking
- Strategy & Consultancy
- Media, Digital & Creative
- Purchasing
- Energy
- FMCG
- Graduate Training & Internships
- Scientific
- Leisure & Tourism
- Security & Safety
- Charity & Voluntary
- Training
- Apprenticeships
skills: string, max length of 400 characters. Example
- graphic design,3d,cad
- swimming,life saving,beach
end_date: Required, must match the format YYYYMMDD. Example
- 2026-04-01
questions: Optional, array, max 5 items, each item must be a string with a max length of 255 characters. Example
- ["a question?"]
questions: Optional, array, max 5 items, each item must be a string with a max length of 255 characters. Ensure the answer is in the same position in the array as the question. Example
- ["an answer"]

Example Post


                "job_title": "Project Manager",
                "description": "This is an example of text with rich text",
                "salary_min": 300,
                "salary_max": 400,
                "salary_type": "per-day",
                "currency": "GBP",
                "country": "United Kingdom",
                "location": "London",
                "postcode": "EC1A 2BP",
                "contract_type": "contract",
                "employment_hours": "full-time",
                "end_date": "2025-04-01",
                "send_to": "email@example.com",
                "display_salary": true,
                "salary_options" : "commission",
                "remote": true,
                "uk_worker": false,
                "student_eligibility": false,
                "public_sector": true,
                "benefits_salary": true,
                "ote_salary": true,
                "prorata_salary": true,
                "negotiable_salary": true,
                "coverletter_required": "yes",
                "reference_number": "1234567",
                "work_from_home": true,
                "sector": "Admin",
                "skills": "projects,teamwork",
                "questions": ["is this a question?","is this another question?"],
                "answers": ["yes","no"]