--- title: "Get all candidates for a job from Workable API" url: "http://35.223.47.52/blog/get-all-candidates-for-a-job-from-workable-api-d9oljb/" date: "2026-08-13T12:59:55+00:00" modified: "2026-08-22T15:43:52+00:00" type: "post" --- # Get all candidates for a job from Workable API [Blog](http://35.223.47.52/blog) / [Tutorials](http://35.223.47.52/blogs/tutorials/) / Get all candidates for a job from Workable API [Tutorials](http://35.223.47.52/blogs/tutorials/) · August 13, 2026 Get all candidates for a job from Workable API ============================================== ![](https://storage.googleapis.com/knit-website-media/2026/08/64c34c8eb1ffc79e7f787ecd_Akshat-3-150x150.png)Akshat Jain 3 min read [](https://www.linkedin.com/sharing/share-offsite/?url=http%3A%2F%2F35.223.47.52%2Fblog%2Fget-all-candidates-for-a-job-from-workable-api-d9oljb%2F) [](https://twitter.com/intent/tweet?url=http%3A%2F%2F35.223.47.52%2Fblog%2Fget-all-candidates-for-a-job-from-workable-api-d9oljb%2F&text=Get%20all%20candidates%20for%20a%20job%20from%20Workable%20%20API) Table of Contents - [Introduction](#introduction) - [Get all candidates for a job from Workable API](#get-all-candidates-for-a-job-from-workable-api) - [Step 1: Set up your environment](#step-1-set-up-your-environment) - [Step 2: Define the API endpoint and parameters](#step-2-define-the-api-endpoint-and-parameters) - [Step 3: Handle the response](#step-3-handle-the-response) - [Knit for Workable API Integration](#knit-for-workable-api-integration) Introduction ------------ This article is a part of a series of articles covering the workable API in depth, and covers the specific use case of using the workable API to Get all candidates for a job from Workable API. You can find all the other use cases we have covered for the workable API along with a comprehensive deep dive on its various aspects like authentication, rate limits etc [here.](/blog/workable-api-directory/) Get all candidates for a job from Workable API ---------------------------------------------- To retrieve all candidates for a specific job using the Workable API, you can follow these steps. This guide will help you fetch the first name, last name, and email of each candidate who has applied for a particular job. ### Step 1: Set up your environment Ensure you have the necessary libraries installed. You can install the required libraries using pip: ``` pip install requests ``` ### Step 2: Define the API endpoint and parameters Use the `/candidates` endpoint to get a list of candidates for a specific job. You will need to provide the job’s shortcode as a query parameter. #### Example Request: ``` import requests subdomain = 'your_subdomain' shortcode = 'your_job_shortcode' access_token = 'your_access_token' url = f'https://{subdomain}.workable.com/spi/v3/candidates' headers = { 'Content-Type': 'application/json', 'Authorization': f'Bearer {access_token}' } params = { 'shortcode': shortcode, 'stage': 'applied' } response = requests.get(url, headers=headers, params=params) candidates = response.json().get('candidates', []) for candidate in candidates: print(f"First Name: {candidate.get('firstname')}, Last Name: {candidate.get('lastname')}, Email: {candidate.get('email')}") ``` ### Step 3: Handle the response The response will contain a list of candidates. Each candidate object will have keys such as `firstname`, `lastname`, and `email`. You can iterate through the list and extract the required information. #### Example Response: ``` { "candidates": [ { "id": "ce4da98", "firstname": "Lakita", "lastname": "Marrero", "email": "lakita_marrero@gmail.com", "stage": "applied" }, { "id": "108d1748", "firstname": "Cindy", "lastname": "Sawyers", "email": "cindy_sawyers@gmail.com", "stage": "applied" } ] } ``` By following these steps, you can efficiently retrieve and display the first name, last name, and email of each candidate who has applied for a specific job using the Workable API. Knit for Workable API Integration --------------------------------- For quick and seamless access to [workable](/integration/workable/) API, Knit API offers a convenient solution. By integrating with Knit just once, you can streamline the entire process. Knit takes care of all the authentication, authorization, and ongoing integration maintenance, this approach not only saves time but also ensures a smooth and reliable connection to your [workable](/integration/workable/) API. --- **Ready to build this integration?** Explore Knit’s [Workable integration](/integration/workable/) or read more about our [Unified ATS API](/integration-categories/unified-ats-api/). ![](https://storage.googleapis.com/knit-website-media/2026/08/64c34c8eb1ffc79e7f787ecd_Akshat-3-150x150.png)Written by Akshat Jain Coding chaos into innovation and building from zero to scale Keep Reading ------------ ![](https://storage.googleapis.com/knit-website-media/2026/08/blog-banner-red-scaled-640x400.png) [Tutorials](http://35.223.47.52/blogs/tutorials/) ### [Get all open jobs from Workable API](http://35.223.47.52/blog/get-all-open-jobs-from-workable-api-a7ih5o/) Technical guide on workable API to Get all open jobs from Workable API August 13, 2026 · 3 min read ![](https://storage.googleapis.com/knit-website-media/2026/08/blog-banner-yellow-scaled-640x400.png) [API Directory](http://35.223.47.52/blogs/api-directory/) ### [Workable API Directory](http://35.223.47.52/blog/workable-api-directory/) Integrate Workable with your HR and recruiting stack using Workable APIs. Automate candidate workflows, sync jobs and hiring teams, trigger… August 13, 2026 · 31 min read ![](https://storage.googleapis.com/knit-website-media/2026/08/blog-banner-green-640x400.png) [Tutorials](http://35.223.47.52/blogs/tutorials/) ### [How to Create a Slack Bot in 5 Minutes: A to Z Guide](http://35.223.47.52/blog/how-to-create-a-slack-bot/) You can create your own Slack Bot in just a few minutes with the Knit Unified API. Read this step-by-step… August 13, 2026 · 3 min read \#1 in Ease of Integrations --------------------------- ![4.9 out of 5 stars](/wp-content/themes/knit/assets/images/g2/g2-star-rating.svg) 4.9 out of 5 stars on G2 ![G2 Leader, Spring 2026](/wp-content/themes/knit/assets/images/g2/g2-leader.svg)![G2 Fastest Implementation, Spring 2026](/wp-content/themes/knit/assets/images/g2/g2-fastest-implementation.svg)![G2 High Performer, Spring 2026](/wp-content/themes/knit/assets/images/g2/g2-high-performer.svg)![G2 Best Est. ROI, Spring 2026](/wp-content/themes/knit/assets/images/g2/g2-best-roi.svg) Put Integrations on Autopilot. Talk to Experts. ----------------------------------------------- Knit is loved by customers across the globe due to our seamless product and white glove support. You'll love us too! [Talk to a Human](/book-demo)