Developer Documentation: Job API

Base Url:

https://{region}.voceer.com/api/v1

Please ensure you specify the subdomain {region}. We currently only support 'uk'.

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"]