NHSJob API Integration
Connect your recruitment systems directly to NHSJob with our powerful and flexible API.
// Example API Request
const response = await fetch(
'https://api.nhsjob.com/v1/jobs',
{
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
title: 'Senior Nurse',
location: 'London',
salary: '£45,000',
description: '...'
})
}
);API Capabilities
Our comprehensive API allows you to integrate NHSJob functionality directly into your recruitment systems.
Job Management
Post, update, and remove job listings programmatically. Manage job applications and candidate interactions.
Candidate Access
Search and filter candidate profiles based on skills, experience, and qualifications specific to healthcare roles.
Data Synchronization
Keep your systems in sync with real-time updates. Webhook support for events like new applications or status changes.
Technical Specifications
Our API is built with modern standards and best practices for developer experience.
RESTful Architecture
Clean, intuitive endpoints following REST principles. JSON responses with consistent structure and comprehensive error handling.
GET /api/v1/jobs
GET /api/v1/jobs/:id
POST /api/v1/jobs
PUT /api/v1/jobs/:id
DELETE /api/v1/jobs/:idSecurity & Authentication
Secure API access with OAuth 2.0 and API keys. HTTPS-only endpoints with rate limiting and comprehensive audit logging.
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5...
Content-Type: application/json
X-API-Version: 1.0Developer Tools
Comprehensive documentation, interactive API explorer, client libraries for popular languages, and sandbox testing environment.
Performance & Reliability
Global CDN distribution, 99.9% uptime SLA, and enterprise-grade infrastructure with comprehensive monitoring.
Integration Examples
Get started quickly with these code examples in popular programming languages.
// Post a new job listing
const postJob = async () => {
try {
const response = await fetch('https://api.nhsjob.com/v1/jobs', {
method: 'POST',
headers: {
'Authorization': 'Bearer YOUR_API_KEY',
'Content-Type': 'application/json'
},
body: JSON.stringify({
title: 'Senior Nurse Practitioner',
department: 'Emergency Care',
location: {
city: 'Manchester',
postcode: 'M1 7DN'
},
salary: {
min: 45000,
max: 55000,
currency: 'GBP'
},
contract_type: 'permanent',
hours: 'full_time',
description: 'We are seeking an experienced Senior Nurse Practitioner...',
requirements: [
'NMC Registration',
'Minimum 5 years experience',
'Emergency care background'
],
application_url: 'https://your-ats.example.com/jobs/12345',
reference_id: 'YOUR_INTERNAL_ID'
})
});
const data = await response.json();
console.log('Job posted successfully:', data);
return data;
} catch (error) {
console.error('Error posting job:', error);
}
};Ready to Integrate with NHSJob?
Get started with our API to streamline your healthcare recruitment processes.