Recruiter API

Programmatically hire Data Champs, manage jobs, and track applications through our REST API.

Getting Started

The Wadata Recruiter API lets external recruiters and BPO firms manage jobs, search for Data Champs, and handle the full hiring workflow. To get started:

Contact us at support@wadata.africa to register your organization
Receive your API key via email with full setup instructions
Start making requests using the endpoints below

Authentication

All API requests require a Bearer token in the Authorization header.


                  Authorization: Bearer wadata_live_your_api_key_here

Important: Your API key is shown only once when issued. Store it securely and never expose it in client-side code.

Base URL


                  https://wadata.africa/api/v1/recruiter

All endpoints are prefixed with this base URL. Responses are in JSON format.

Organization Info

Verify your API key and view organization details.


                  GET /me

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://wadata.africa/api/v1/recruiter/me

Jobs Management

Scope: jobs:read, jobs:write

Method	Endpoint	Description
GET	/jobs	List all your jobs
POST	/jobs	Create a new draft job
GET	/jobs/:id	Get job details with applications
PUT	/jobs/:id	Update a job
POST	/jobs/:id/publish	Publish a draft job (makes it visible to Data Champs)
POST	/jobs/:id/pause	Pause an active job
POST	/jobs/:id/resume	Resume a paused job
POST	/jobs/:id/close	Close a job permanently

Create a Job

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Survey Enumerator",
    "description": "Conduct household surveys in Nairobi",
    "job_type": "survey",
    "location_type": "on_site",
    "rate": "500",
    "rate_type": "daily",
    "currency": "KES",
    "number_of_positions": 10,
    "required_skills": ["data_collection", "swahili"]
  }' \
  https://wadata.africa/api/v1/recruiter/jobs

Valid Job Types

survey audit labeling annotation custom transcription verification voice_recording photo_survey data_entry analytics

Applications

Scope: jobs:read, jobs:write

Method	Endpoint	Description
GET	/jobs/:job_id/applications	List applications for a job
GET	/jobs/:job_id/applications/:id	Get application details
POST	/jobs/:job_id/applications/:id/accept	Accept (hire) a Data Champ
POST	/jobs/:job_id/applications/:id/reject	Reject an application (with optional reason)
PATCH	/jobs/:job_id/applications/:id	Update application status (e.g., shortlist)
POST	/jobs/:job_id/applications/:id/approve-work	Approve submitted work

Accept an Application

curl -X POST \
  -H "Authorization: Bearer YOUR_API_KEY" \
  https://wadata.africa/api/v1/recruiter/jobs/42/applications/15/accept

Data Champ Discovery

Scope: data_champs:read

Method	Endpoint	Description
GET	/data-champs	Search and filter Data Champs
GET	/data-champs/:id	View a Data Champ's public profile
GET	/jobs/:job_id/data-champs/matches	Get recommended matches for a job

Search with Filters

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://wadata.africa/api/v1/recruiter/data-champs?skills=data_collection,swahili&country=Kenya&verified_only=true&per_page=20"

Available Filters

Parameter	Type	Description
skills	string	Comma-separated list of skills
location	string	City or region name
country	string	Country name
availability	string	available, busy, or unavailable
min_rate / max_rate	number	Daily rate range filter
verified_only	boolean	Only return verified Data Champs
search	string	Search by name
page / per_page	integer	Pagination (default: page 1, 25 per page)

Error Responses

Status	Meaning
401	Invalid or missing API key
403	Missing required scope or accessing another client's resource
404	Resource not found
422	Validation error (check the `errors` field in the response)

Need Help?

Our team is ready to help you integrate with the Wadata API.

Contact Support