https://usa.voceer.com/api/v1
Please ensure you specify the subdomain 'usa'. We currently only support 'usa on usa.voceer.com'.
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" }`
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
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",
...
}
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",
...
}
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",
...
}
Each field in the job posting request has specific validation rules:
"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"]