Home

Developer Documentation: Job API

Base Url:

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

Please ensure you specify the subdomain 'usa'. We currently only support 'usa on usa.voceer.com'.

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:

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": "USD",
                "country": "United States",
                "location": "Cold Bay",
                "postcode": "99571",
                "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,
                "eligible_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"]