Curriculo ATS REST API
Full programmatic access to your hiring data. Create jobs, pull candidate scores, sync pipelines, and build custom workflows. Available on the Pro plan ($50/mo).
The CurriculoATS REST API provides full programmatic access to your hiring data, enabling teams to create jobs, retrieve candidate scores, manage pipeline stages, and build custom integrations with HRIS, payroll, and reporting tools. The API uses standard REST conventions with JSON responses, API key authentication, and webhook events for real-time updates. Available on the Pro plan at $50 per month, with no per-request charges within rate limits.
API Capabilities
CRUD for Jobs & Candidates
Create, read, update, and delete jobs and candidates programmatically. Post new job listings from internal tools, update candidate stages in bulk, and sync candidate profiles with external systems. Full CRUD operations on all core resources.
Scores & Pipeline Data
Retrieve Impact Scores (0–100) and dimension breakdowns for every candidate. Query pipeline stages, track candidate progression, and pull aggregated hiring metrics for custom dashboards and reporting.
Webhook Events
Subscribe to real-time webhook events: new application received, candidate scored, stage change, offer sent, candidate hired. Each webhook delivers a JSON payload with full event context to your endpoint.
Bulk Export
Export candidate data, scoring results, and pipeline snapshots in bulk. Pull all candidates for a role, all scores across roles, or full pipeline history for compliance and reporting requirements.
Use Cases
Sync with HRIS & Payroll
When a candidate is marked as hired in CurriculoATS, automatically push their profile to your HRIS (BambooHR, Rippling, etc.) or payroll system (Gusto, ADP). Eliminate manual data entry between hiring and onboarding.
Custom Analytics Dashboards
Pull hiring metrics via the API and build custom dashboards in your BI tool of choice — Looker, Metabase, or Google Sheets. Track time-to-hire, source quality, score distributions, and funnel conversion rates.
Automated Job Posting
Create job listings in CurriculoATS programmatically from your internal tools or career site CMS. When your team opens a new role, the API creates the job, sets scoring criteria, and activates the pipeline automatically.
Candidate Data Enrichment
Use webhooks to trigger enrichment workflows when new candidates apply. Pull additional data from Clearbit, LinkedIn, or your own databases, then write enriched profiles back to Curriculo ATS via the API.
Authentication & Rate Limits
API Key Authentication
Generate an API key from your CurriculoATS dashboard under Settings > API. Include the key in the Authorization header of every request. Keys can be rotated at any time without disrupting active integrations.
Rate Limits
Standard rate limits are 100 requests per minute per API key. The API returns 429 status codes when limits are exceeded, with a Retry-After header indicating when to retry. Higher limits are available on the Enterprise plan.
Documentation
Full API documentation is available in the CurriculoATS developer portal for Pro plan subscribers. Includes interactive API explorer, code examples in cURL, Python, Node.js, and Ruby, plus webhook testing tools.
Code Example
Create a new job listing with a single API call.
# Create a new job listing curl -X POST https://api.curriculo.me/v1/jobs \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "title": "Senior Backend Engineer", "department": "Engineering", "location": "Remote", "employment_type": "full_time", "description": "Build and scale our API infrastructure...", "scoring_criteria": { "role_fit_weight": 40, "outcomes_weight": 35, "context_weight": 25 } }'
Is the API free?
The REST API is available on the Pro plan at $50/month. The Pro plan includes unlimited API calls within rate limits, webhook events, and full documentation access.
Are there rate limits?
Yes. Standard rate limits are 100 requests per minute per API key. The API returns a 429 status code with a Retry-After header when limits are exceeded. Higher limits are available on the Enterprise plan.
Does the API support webhooks?
Yes. CurriculoATS sends webhook events for key actions: new application, candidate scored, stage change, offer sent, and candidate hired. Configure webhook endpoints in your dashboard settings.
Where can I find API documentation?
Full API documentation will be available at launch in the CurriculoATS developer portal. Pro plan subscribers get access to interactive API docs, code examples in multiple languages, and webhook testing tools.