Developer Resources

Build innovative healthcare recruitment solutions with NHSJob's developer tools and APIs.

Sandbox Environment

The NHSJob Sandbox Environment allows you to test your integration with our API in a safe, isolated environment before deploying to production.

To use the sandbox environment, you'll need separate API credentials for testing. These credentials will only work with the sandbox endpoints.

https://sandbox-api.nhsjob.net/v1

The sandbox environment includes pre-populated test data for jobs, candidates, employers, and applications.

Test various API responses, including error conditions, by using special test parameters.

Trigger webhook events manually to test your webhook handlers without waiting for actual events.

Test how your application handles rate limiting with lower thresholds than production.

The following test accounts are available for use in the sandbox environment:

Account Type	Email	Password	Notes
Candidate	test.candidate@example.com	sandbox-pass	Has complete profile with resume
Employer	test.employer@example.com	sandbox-pass	Has active job listings
Recruiter	test.recruiter@example.com	sandbox-pass	Agency with multiple job listings
Admin	test.admin@example.com	sandbox-pass	Has admin privileges

The sandbox environment includes a test payment gateway that simulates payment processing without charging real money.

Use any future expiration date, any 3-digit CVC, and any postal code.

Trigger specific error responses by using the following test values:

Use job ID error_not_found to simulate a 404 Not Found response
Use candidate ID error_unauthorized to simulate a 401 Unauthorized response
Use error_rate_limit as a query parameter to simulate a 429 Rate Limit Exceeded response

Once you've thoroughly tested your integration in the sandbox environment, you're ready to switch to the production API.