# GetMattered API > Apply to jobs by API and know when the employer confirmed each one. Then score, parse and tailor resumes and write cover letters. To run a job search from an AI assistant, use the GetMattered MCP server at https://getmattered.com/mcps. > ## Agent instructions > The API is served at https://api.getmattered.com/api/v1. Every request and response body is JSON. > Authenticate with `Authorization: Bearer $GETMATTERED_API_KEY`. A key starts with `gm_live_`. A person creates it, signed in, at https://getmattered.com/dashboard/developers. An agent cannot create a key, and a key belongs on a server, never in browser or app code. > The OpenAPI 3.1 document at https://getmattered.com/docs/openapi.json is the source of truth for request and response schemas. > Every page has a Markdown twin: add `.md` to its URL. https://getmattered.com/docs/llms-full.txt holds every page in one file. > An MCP server for these docs runs at https://getmattered.com/docs/mcp (Streamable HTTP, no key). Its tools list, read and search the pages. > To run a job search from an AI assistant without writing code, use the GetMattered MCP server: https://getmattered.com/mcps. > An application counts as landed only when the employer confirmed it. Read `GET /developer/applications/{id}` for that; do not infer it from the answer to `POST /developer/apply`. - [GetMattered API](/docs/index.md): Apply to jobs by API and know when the employer confirmed each one. Then score, parse and tailor resumes and write cover letters. - [Quickstart](/docs/quickstart.md): Create an API key, send your first application, and score a resume. - [SDKs](/docs/sdks.md): The official TypeScript SDK, getmattered on npm. Typed calls for every endpoint, typed errors, retries and the webhook signature check. - [Authentication](/docs/authentication.md): Create a key in the dashboard and send it as a Bearer token. - [Key scopes](/docs/key-scopes.md): What a key may do, which calls need the apply scope, and how to pick scopes when you create a key. - [Pricing](/docs/pricing.md): API calls spend prepaid API tokens, apart from the GetMattered app plans. - [Rate limits](/docs/rate-limits.md): 60 calls a minute per key. - [Errors](/docs/errors.md): The error envelope, the HTTP status codes and the error codes. - [Application states](/docs/application-states.md): Every state an application started by API can be in, what each one means for you, and which webhook event fires. - [Data and privacy](/docs/data-and-privacy.md): Who the API is for, and how calls with personal data run. - **Guides** - [Apply to a job by API](/docs/guides/apply-to-a-job.md): Send a job link. GetMattered fills the employer's form from your account, sends it, and tells you when the employer confirmed it landed. - [Parse a resume to JSON](/docs/guides/parse-resume-to-json.md): Turn a resume into clean JSON with contact details, work history, education and skills. Each contact fact comes with the line of the resume it came from. - [Score a resume against a job post](/docs/guides/score-resume-against-job.md): Show a job seeker how well their resume matches a posting, which keywords it misses and what to fix. Then close the gap with one more call. - [Receive webhooks](/docs/guides/receive-webhooks.md): Get a signed event when an application lands, stops, needs the account owner or waits for approval, and check the signature before you trust it. - **API reference** - Candidate - [Read the candidate profile](/docs/reference/profile-get.md): The candidate's name, contact, location, work authorization and links: the facts GetMattered fills application forms with. Free. - [Update the candidate profile](/docs/reference/profile.md): Changes the fields you send and leaves the rest. Send `null` to clear a field. The same fields the candidate edits in GetMattered. Free. - [Read the resume](/docs/reference/resume-get.md): The resume GetMattered applies with: the candidate's base resume, as text. 404 when the candidate has none yet. Free. - [Upload a resume](/docs/reference/resume.md): Uploads a new resume for the candidate, the way the GetMattered upload does: the same file types and 10 MB limit, and it becomes the resume GetMattered applies with. GetMattered reads the file before it answers, so the answer carries the text it read. Spends the tokens it uses plus the request fee, recorded as `parse`. At most 10 uploads a minute per account. - [Read job preferences](/docs/reference/preferences-get.md): The candidate's job preferences: target titles, locations, remote, salary and the rest, in the shape GetMattered saves them. The defaults when none are saved. Free. - [Save job preferences](/docs/reference/preferences.md): Saves the candidate's job preferences the way GetMattered saves them: titles and places are matched to known ones, then the matches are rebuilt for the new search. Fields you omit stay as saved. At most 6 saves in 5 minutes per account, the app's limit. Free. - Jobs - [Read a job](/docs/reference/jobs-id.md): One of the candidate's matches in full: description, pay, fit and whether GetMattered can apply to it (`canSend`). Free. - [List the candidate's matches](/docs/reference/jobs/matches.md): The candidate's matches: the jobs GetMattered found for their preferences and has not shown as decided, best fit first, the deck the candidate sees in the app. Reading it changes nothing. Free. - [Search jobs](/docs/reference/jobs/search.md): Searches the whole job supply by title and place, beyond the candidate's matches. Answers only jobs GetMattered can apply to now, best first, at most 10: narrow the search rather than page it. Omit `query` and `location` to search the candidate's saved preferences. Pass a result's `jobUrl` to `POST /developer/apply`. Free. - Applications - [Apply to a job posting](/docs/reference/apply.md): Needs a key made with the `apply` scope. Applies to one job posting for the key owner's own account, the way GetMattered applies from the app: it resolves the link to the employer's posting, prepares the application and sends it, or holds it for the owner's approval. Answers at once; read the outcome from `GET /developer/applications/{id}`. The same posting twice answers with the same application. A stopped application starts again, except one `held` or one the owner cancelled. It spends the API balance, never the app plan, and needs 40,000 API tokens there for each application in progress plus this one to start; a running application finishes even if it takes the balance below zero, and the next call is refused until a top-up. At most 5 applications started by API are in progress at once, and an account reads at most 5 postings a minute across its keys. Spends the tokens the application uses plus the request fee, recorded as `apply`. A call refused before the posting is read spends nothing; once the posting is read, the call pays the request fee whatever it answers. - [List applications](/docs/reference/applications.md): Your applications, newest first, with the same states as `GET /developer/applications/{id}`. Filter by `status` and `since`; page with `cursor`. Free. - [Read an application](/docs/reference/applications-id.md): Where one of your applications stands. `landed` only when the employer confirmed it, by their own email or their confirmation page. Free. - [Approve a held application](/docs/reference/applications-id/approve.md): Needs a key made with the `apply` scope. Approves an application in `held_for_review` and sends it, the way the account owner approves it in GetMattered. An application GetMattered cannot send stays held or ends `not_landed`; the answer is its state after the approval. An application started in GetMattered is paid by the app plan, one started by API by the API balance. Free. - [Cancel an application](/docs/reference/applications-id/cancel.md): Needs a key made with the `apply` scope. Cancels an application that is queued, being prepared or held for review, before GetMattered starts sending it. 409 once sending started or the application ended. A cancelled application is never sent again by `POST /developer/apply`. Free. - Resume tools - [Score a resume for ATS compatibility](/docs/reference/ats-score.md): Scores resume text for ATS compatibility, against a job posting when one is sent. Spends the tokens it uses plus the request fee, recorded as `ats_score`. - [Parse a resume into structured fields](/docs/reference/parse.md): Parses resume text into structured fields: contact, work history, education, skills and suggested titles. Spends the tokens it uses plus the request fee, recorded as `parse`. - [Analyze a job posting](/docs/reference/analyze-job.md): Extracts the keywords a recruiter screens for from a job posting, with category and importance. Spends the tokens it uses plus the request fee, recorded as `analyze_job`. - [Tailor a resume to a job posting](/docs/reference/tailor.md): Tailors a resume to a job posting and scores it before and after. `light` is a quick rewrite, `pro` a deeper rewrite. Spends the tokens it uses plus the request fee, recorded as `light_cv_pack` or `pro_cv_pack`. - [Parse, score and tailor a resume in one call](/docs/reference/cv-pack.md): Parses the resume, scores it, tailors it to the posting and scores the result, in one call. Spends the tokens it uses plus the request fee, recorded as `light_cv_pack` or `pro_cv_pack` by `tier`. - [Write a cover letter](/docs/reference/cover-letter.md): Writes a first-person cover letter for a job posting from the resume. Spends the tokens it uses plus the request fee, recorded as `cover_letter`. - Webhooks - [List webhook endpoints](/docs/reference/webhooks-get.md): Your account's webhook endpoints. The secret is never shown again; `secretPrefix` tells them apart. Free. - [Add a webhook endpoint](/docs/reference/webhooks.md): Adds a webhook endpoint to your account, at most 5. Answers the signing secret once. GetMattered POSTs a JSON event (`DeveloperWebhookEvent`) when one of your applications becomes `landed`, `not_landed`, `needs_you` or `held_for_review`, usually within two minutes. Each delivery carries `GetMattered-Signature: t=,v1=." under the endpoint secret>`, plus `GetMattered-Event-Id` and `GetMattered-Event-Type`. Answer 2xx within 10 seconds. Anything else is retried after 1 minute, 5 minutes, 30 minutes, 2, 5, 10 and 24 hours, then the delivery is marked `failed`. The same event can arrive twice: skip an `id` you have seen. Free. - [Delete a webhook endpoint](/docs/reference/webhooks-id.md): Deletes a webhook endpoint. Deliveries not yet sent to it are dropped. Free. - [Read webhook deliveries](/docs/reference/webhooks-id/deliveries.md): The newest 20 deliveries to one endpoint: event, status, attempts and the last HTTP status your endpoint answered. Free. - [Send a test event](/docs/reference/webhooks-id/test.md): Queues one `webhook.test` event to the endpoint, signed like every event. It is sent within a minute; read the result from `GET /developer/webhooks/{id}/deliveries`. Free. - Billing - [Read your API balance](/docs/reference/balance.md): The API tokens your account can spend now. API calls spend this balance, never your GetMattered plan. Free. - [Read your monthly usage](/docs/reference/usage.md): Calls and the tokens they spent for each of your API keys in one calendar month (UTC). Defaults to the current month. Free.