# Curriculo ATS Documentation: API, limits, billing and MCP

> Official product documentation for the Curriculo ATS API and the Curriculo ATS MCP server. Six API capabilities for CV parsing, candidate evaluation, translation, language detection, interview analysis and a resume assistant. Includes authentication, per-capability request reference, published rate limits, usage-based billing, and data-handling terms.

**Source:** https://curriculo.me/docs/ (Curriculo ATS)
**Publisher:** Curriculo Inc., Brooklyn, NY. Last updated 27 August 2026.

## What is the Curriculo ATS API?

The Curriculo ATS API turns raw hiring material into structured, decision-ready data. You send a CV, a job requirement or an interview recording, and you get back clean fields, a fit score, a translation or a hiring summary. It exposes the same engines the Curriculo ATS product already runs, called directly with a Bearer key from the Developer Console. There is no ATS login, no session cookie and no organisation header involved.

Every input that can be a list is a list. Send one item or a hundred: the response comes back as a list in the order you sent it, one result per item. A single item failing never collapses the rest of the batch.

## Key facts

- Capabilities: 6 (parse CV, evaluate candidate, translate, detect language, interview summary, resume assistant)
- Authentication: `Authorization: Bearer key_...` from console.curriculo.me
- Free credit: one-time $5.00 on sign-up, no payment method required to start
- Billing: usage-metered per call, no subscription, no monthly minimum
- Translation languages: 85 on a dedicated engine, with AI model fallback beyond that set
- Document size limit: 10 MB
- CV processing time: 40 to 90 seconds
- Rate limit: 600 requests per minute per key
- Interactive reference: https://api.curriculo.me/public/docs
- MCP server (separate product): https://mcp.curriculo.me/mcp

## The six capabilities

| Capability | What you send | What you get back |
|---|---|---|
| Parse CV | One CV or a list of CVs, PDF or Word. One file is one charge. | The full resume as structured data: name, contact details, work history, education, skills. Values stay in the CV's own language and script. |
| Evaluate candidate | Register the job once as careers-page text, a JSON string, or a job PDF/DOCX. Then send one CV or a list of CV PDFs against that job. | Per CV: suitability score, written reasons, matched skills and gaps. The same evaluation the Curriculo ATS app shows recruiters. |
| Translate | A list of texts (up to 200) or a PDF/DOCX upload. Always a list. | All of them translated in one go, in the order you sent them. If one item fails, the rest still come back. |
| Detect language | One text, or a list of texts, in a single call. | The language it is written in, which lets you route a CV or a message before you act on it. |
| Interview summary | Video (mp4, mov, mkv) or audio (mp3, m4a, wav), or a transcript you already have. | The transcription, then AI analysis covering highlights, red flags, skills and a recommendation. Transcript-only requests skip transcription. |
| Resume assistant | A CV once, then plain-language instructions. | A working session over that CV: ask questions, edit sections, or produce a translated version without re-uploading the file. |

The first five capabilities are one-shot: nothing you send is stored, and no information carries from one request to the next. The resume assistant is the only one that keeps a working copy, so it can act on the same CV across a session.

## How do I get started with the Curriculo ATS API?

1. Create an account at console.curriculo.me. Sign-up is self-serve, so no sales call is needed to begin.
2. Generate an API key on the API Keys page. The key is shown once, so store it somewhere safe. If it is lost or exposed, revoke it and issue a new one. Existing keys keep working until you revoke them.
3. Try each capability before writing code. Open https://api.curriculo.me/public/docs, click Authorize, paste `Authorization: Bearer key_...`, and use "Try it out" on any operation, file upload included.
4. Hand the key to your engineering team. They need the key, the console templates, and the Postman collection from the console docs page. Each capability is a single request.

A console key activates all six capabilities immediately, on the same account and the same balance. There is no onboarding call and no per-capability request.

## Request reference

**Parse CV.** `files` (required): one or more CVs in PDF or DOCX, up to 10 MB each. Attach a single file or a list; results come back in the same order.

**Evaluate candidate.** `job_id` (one of these): from `POST /jobs/`, an evaluate helper rather than the Curriculo ATS Jobs API. `resume_pdf` or `resume_pdfs` (required): one CV or several, PDF, up to 10 MB each. `job_details` (one of these): a string of careers-page prose, or a JSON string. `language` (optional): language for the written analysis, English if left out.

**Translate.** `texts` (required): up to 200 items and 50,000 characters per request, order preserved. `target_language` (required). `source_language` (optional): English assumed if left out.

**Detect language.** `text` (required): up to 50,000 characters. `default_language` (optional): what to return when the text is too short or too mixed to call, English by default.

**Interview summary.** `interview_id` (required): your own reference, echoed back. `media` or `transcript_text` (one of these): video/audio, or a transcript up to 200,000 characters. `transcript_entries` (optional): the same transcript split into speaker turns, which also returns speaking-time analytics. `language` (optional): English by default.

**Resume assistant.** `prompt_text` (required): your instruction or question in plain language, in any language. `file` (first call only): attach the CV once to open the session. `language` (optional): renders the resume in that language, which is how translation is requested.

## Limits and performance

These are measured on production, not projected.

| What | Value |
|---|---|
| Document size | Up to 10 MB |
| CV processing time | 40 to 90 seconds |
| Sustained throughput | 2 to 4 CVs per minute, roughly 150 to 250 per hour |
| Documents in flight | 3 at a time; extras wait their turn rather than failing |
| Request rate per key | 600 per minute |
| Translation in one call | 200 items / 50,000 characters |
| Interview transcript | 200,000 characters |
| Text for language detection | 50,000 characters |

Throughput is shared service capacity rather than capacity reserved for one customer. CV processing is real AI analysis rather than keyword matching, so treat it as a background job rather than something that blocks a page load.

## Billing

Self-serve billing is pay as you go. A one-time $5.00 credit is granted on sign-up and drawn down before anything is charged. Each call is metered on what it actually consumes, to a millionth of a dollar, so a short instruction costs a fraction of a cent and a long document costs proportionally more. When your balance falls below a threshold you choose, your card is charged to top it back up, so calls never stop mid-workload. Card details are entered on Stripe's own pages. There is no monthly plan and no billing cycle, and you pay nothing in a period where you make no calls.

One file in a request is one charge. A list of ten CVs is ten charges. All figures are USD and exclude local taxes. Resale and committed-volume pricing is contracted per engagement and is not the self-serve rate.

## Data handling

Outside the resume assistant session, Curriculo ATS does not retain the documents you send. A key is bound to your organisation and sees nothing else. Parsed output preserves the CV's own language and script, so no name or employer is transliterated without you asking for it. Revocation is immediate and self-serve.

CVs and interview recordings are personal data, and the customer remains the data controller. Data residency and local-currency invoicing are handled per engagement.

## Curriculo ATS MCP: a separate product

MCP is not the public API. It talks to the Curriculo ATS over OAuth, so the user signs in with a Curriculo ATS account and approves access. A public API `key_` does not reach these tools, and the public API does not reach your ATS.

Connector address: `https://mcp.curriculo.me/mcp`

Twenty-five tools are available to the assistant. Seventeen are read-only, two write ATS data, and six write data and reach outside (an email leaves, an invite is sent, or an AI job starts). No tool deletes your data. Every action stays scoped to your organisation, and actions with outside effects are confirmed before they run.

The assistant can review the pipeline, search the candidate pool in plain language, move applicants between stages, book interviews, and read or reply to candidate email threads.

Full MCP documentation: https://curriculo.me/docs/mcp/

## Frequently asked questions

**Do I need to talk to sales to get an API key?** No. Sign-up is self-serve at console.curriculo.me, and a one-time $5.00 free credit covers your evaluation. No payment method is required to start.

**Does one API key cover every capability?** Yes. A console key activates all six capabilities immediately, on the same account and the same balance.

**Does Curriculo ATS store the documents I send?** Five of the six capabilities are one-shot and store nothing. The resume assistant keeps a working copy so it can act on the same CV across a session.

**Is the MCP server the same product as the public API?** No. The public API uses a Bearer key. The MCP server uses OAuth and requires an existing Curriculo ATS account.

**Is there a subscription or a monthly minimum?** No. Billing is pay as you go, metered on what each call consumes.

**How long does a CV take to process?** 40 to 90 seconds, with sustained throughput of 2 to 4 CVs per minute.

**What happens if one document in a batch fails?** The rest still come back. Re-sending a single failed document is safe, because it cannot create duplicates or half-finished records.

## Related pages

- [Curriculo ATS MCP documentation](https://curriculo.me/docs/mcp/)
- [Curriculo ATS MCP overview](https://curriculo.me/mcp/)
- [Interactive API reference](https://api.curriculo.me/public/docs)
- [Developer Console](https://console.curriculo.me)

Contact: hello@curriculo.me