{"components":{"schemas":{"ApiErrorResponse":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"context":{"oneOf":[{"type":"object","properties":{"errorType":{"type":"string","enum":["validation"]},"field":{"type":"string"},"fieldErrors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"expected":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"},"received":{"type":"string"}},"required":["field","message"]}},"schemaName":{"type":"string"}},"required":["errorType"]},{"type":"object","properties":{"attemptedEmail":{"type":"string","format":"email"},"errorType":{"type":"string","enum":["authentication"]},"failureReason":{"type":"string","enum":["invalid_credentials","account_locked","expired_token","token_expired","missing_token","invalid_token","session_expired","revoked"],"description":"Reason for authentication failure","example":"token_expired"},"ipAddress":{"type":"string"},"operation":{"type":"string"},"service":{"type":"string"},"userAgent":{"type":"string"}},"required":["errorType"]},{"type":"object","properties":{"actualPermission":{"type":"string"},"errorType":{"type":"string","enum":["authorization"]},"requiredPermission":{"type":"string"},"resource":{"type":"string"},"resourceId":{"type":"string"},"userId":{"type":"string"}},"required":["errorType"]},{"type":"object","properties":{"constraint":{"type":"string"},"errorType":{"type":"string","enum":["database"]},"operation":{"type":"string","enum":["insert","update","delete","select","batch","transaction","migration"],"description":"Type of database operation","example":"select"},"resourceId":{"type":"string"},"sqlState":{"type":"string"},"table":{"type":"string"},"userId":{"type":"string"}},"required":["errorType"]},{"type":"object","properties":{"endpoint":{"type":"string"},"errorType":{"type":"string","enum":["external_service"]},"httpStatus":{"type":"number"},"operation":{"type":"string"},"resourceId":{"type":"string"},"responseTime":{"type":"number"},"retryAttempt":{"type":"integer"},"service":{"type":"string"},"serviceName":{"type":"string"},"userId":{"type":"string"}},"required":["errorType"]},{"type":"object","properties":{"errorType":{"type":"string","enum":["resource"]},"resource":{"type":"string"},"resourceId":{"type":"string"},"service":{"type":"string"},"userId":{"type":"string"}},"required":["errorType"]},{"type":"object","properties":{"errorType":{"type":"string","enum":["rate_limit"]},"limit":{"type":"number"},"resetTime":{"type":"string"},"windowMs":{"type":"number"}},"required":["errorType"]},{"type":"object","properties":{"configKey":{"type":"string"},"errorType":{"type":"string","enum":["configuration"]},"operation":{"type":"string"},"service":{"type":"string"}},"required":["errorType"]}],"description":"Type-safe error context information","example":{"errorType":"validation","fieldErrors":[{"field":"email","message":"Invalid email format"}]}},"details":{"oneOf":[{"type":"object","properties":{"detailType":{"type":"string","enum":["validation"]},"validationErrors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"]}}},"required":["detailType","validationErrors"],"additionalProperties":false},{"type":"object","properties":{"detailType":{"type":"string","enum":["service_error"]},"originalError":{"type":"string"},"serviceName":{"type":"string"}},"required":["detailType","serviceName"],"additionalProperties":false},{"type":"object","properties":{"currentSize":{"type":"number"},"detailType":{"type":"string","enum":["batch"]},"originalError":{"type":"string"},"statementCount":{"type":"number"}},"required":["detailType"],"additionalProperties":false},{"type":"object","properties":{"detailType":{"type":"string","enum":["rate_limit"]},"limit":{"type":"number"},"resetTime":{"type":"string"},"windowMs":{"type":"number"}},"required":["detailType","limit","resetTime","windowMs"],"additionalProperties":false},{"type":"object","properties":{"conflictingField":{"type":"string"},"detailType":{"type":"string","enum":["resource"]},"resourceId":{"anyOf":[{"type":"string"},{"type":"number"}]},"resourceType":{"type":"string"}},"required":["detailType"],"additionalProperties":false},{"type":"object","properties":{"detailType":{"type":"string","enum":["generic"]},"info":{"type":"string"}},"required":["detailType"],"additionalProperties":false},{"type":"object","properties":{"currentTokens":{"type":"integer","minimum":0},"detailType":{"type":"string","enum":["insufficient_tokens"]},"requiredTokens":{"type":"integer","minimum":0}},"required":["currentTokens","detailType","requiredTokens"],"additionalProperties":false}]},"message":{"type":"string"},"validation":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"field":{"type":"string"},"message":{"type":"string"}},"required":["field","message"],"additionalProperties":false}}},"required":["code","message"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[false]}},"required":["error","success"],"additionalProperties":false},"AtsSectionScores":{"type":"object","properties":{"skills":{"type":"number","minimum":0,"maximum":100},"experience":{"type":"number","minimum":0,"maximum":100},"education":{"type":"number","minimum":0,"maximum":100},"formatting":{"type":"number","minimum":0,"maximum":100},"keywords":{"type":"number","minimum":0,"maximum":100}},"required":["skills","experience","education","formatting","keywords"],"additionalProperties":false,"description":"Per-section ATS sub-scores derived from the analysis."},"DeveloperAnalyzeJobRequest":{"type":"object","properties":{"jobDescription":{"type":"string","minLength":50,"maxLength":50000,"description":"The job posting text, 50 to 50,000 characters.","example":"We are hiring a Senior Frontend Engineer with React, TypeScript and GraphQL experience to own our design system..."}},"required":["jobDescription"],"additionalProperties":false},"DeveloperAnalyzeJobResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"keywords":{"type":"array","items":{"$ref":"#/components/schemas/KeywordItem"},"description":"The keywords a recruiter screens for, with category and importance."},"usage":{"$ref":"#/components/schemas/DeveloperCallUsage"}},"required":["keywords","usage"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperApplicationListResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"applications":{"type":"array","items":{"type":"object","properties":{"company":{"type":["string","null"],"example":"Acme"},"id":{"type":"integer","exclusiveMinimum":0,"description":"The application. The same posting always answers with the same id.","example":2481},"jobTitle":{"type":["string","null"],"example":"Senior Frontend Engineer"},"landedEvidence":{"type":"array","items":{"type":"string","enum":["receipt","screenshot"],"description":"Who authored the evidence that this application reached the employer. `receipt` = the employer emailed a confirmation linked to this row. `screenshot` = a review of the stored post-submit screenshot read the employer's OWN confirmation page. Both are the other side's answer and both count as a proven landing; a row may hold either or both.","example":"screenshot"},"description":"The employer's own proof the application landed: `receipt` (their email) and `screenshot` (their confirmation page). Empty unless `status` is `landed`.","example":["receipt"]},"postingUrl":{"type":["string","null"],"example":"https://job-boards.greenhouse.io/acme/jobs/4012345"},"status":{"type":"string","enum":["in_progress","held_for_review","needs_you","landed","held","not_landed"],"description":"`in_progress`: GetMattered is preparing or sending it, or it was sent and the employer has not confirmed it yet. `held_for_review`: ready, and waiting for the account owner to approve it in GetMattered. `needs_you`: waiting on the account owner for something else. `landed`: the employer confirmed it, by their own email or their confirmation page; `landedEvidence` says which. `held`: it stopped, and a mail may be the employer's answer, so GetMattered will not send it again; do not retry. `not_landed`: it stopped without the employer confirming it. Calling apply again for a stopped posting sends it again, except a `held` one or one the owner cancelled.","example":"in_progress"},"tokens":{"type":"integer","description":"Tokens the call that started this application has spent on it so far, the request fee included. 0 for an application started in GetMattered.","example":22130},"trackingUrl":{"type":"string","format":"uri","description":"The application's page in GetMattered, behind the account owner's sign-in.","example":"https://getmattered.com/dashboard/applications/2481"}},"required":["company","id","jobTitle","landedEvidence","postingUrl","status","tokens","trackingUrl"],"additionalProperties":false}},"nextCursor":{"type":["integer","null"],"exclusiveMinimum":0,"description":"Pass it as `cursor` for the next, older page. Null when nothing older is left.","example":2461}},"required":["applications","nextCursor"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperApplicationResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"company":{"type":["string","null"],"example":"Acme"},"id":{"type":"integer","exclusiveMinimum":0,"description":"The application. The same posting always answers with the same id.","example":2481},"jobTitle":{"type":["string","null"],"example":"Senior Frontend Engineer"},"landedEvidence":{"type":"array","items":{"type":"string","enum":["receipt","screenshot"],"description":"Who authored the evidence that this application reached the employer. `receipt` = the employer emailed a confirmation linked to this row. `screenshot` = a review of the stored post-submit screenshot read the employer's OWN confirmation page. Both are the other side's answer and both count as a proven landing; a row may hold either or both.","example":"screenshot"},"description":"The employer's own proof the application landed: `receipt` (their email) and `screenshot` (their confirmation page). Empty unless `status` is `landed`.","example":["receipt"]},"postingUrl":{"type":["string","null"],"example":"https://job-boards.greenhouse.io/acme/jobs/4012345"},"status":{"type":"string","enum":["in_progress","held_for_review","needs_you","landed","held","not_landed"],"description":"`in_progress`: GetMattered is preparing or sending it, or it was sent and the employer has not confirmed it yet. `held_for_review`: ready, and waiting for the account owner to approve it in GetMattered. `needs_you`: waiting on the account owner for something else. `landed`: the employer confirmed it, by their own email or their confirmation page; `landedEvidence` says which. `held`: it stopped, and a mail may be the employer's answer, so GetMattered will not send it again; do not retry. `not_landed`: it stopped without the employer confirming it. Calling apply again for a stopped posting sends it again, except a `held` one or one the owner cancelled.","example":"in_progress"},"tokens":{"type":"integer","description":"Tokens the call that started this application has spent on it so far, the request fee included. 0 for an application started in GetMattered.","example":22130},"trackingUrl":{"type":"string","format":"uri","description":"The application's page in GetMattered, behind the account owner's sign-in.","example":"https://getmattered.com/dashboard/applications/2481"}},"required":["company","id","jobTitle","landedEvidence","postingUrl","status","tokens","trackingUrl"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperApplyResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0,"description":"The application. The same posting always answers with the same id.","example":2481},"status":{"type":"string","enum":["in_progress","held_for_review","needs_you","landed","held","not_landed"],"description":"`in_progress`: GetMattered is preparing or sending it, or it was sent and the employer has not confirmed it yet. `held_for_review`: ready, and waiting for the account owner to approve it in GetMattered. `needs_you`: waiting on the account owner for something else. `landed`: the employer confirmed it, by their own email or their confirmation page; `landedEvidence` says which. `held`: it stopped, and a mail may be the employer's answer, so GetMattered will not send it again; do not retry. `not_landed`: it stopped without the employer confirming it. Calling apply again for a stopped posting sends it again, except a `held` one or one the owner cancelled.","example":"in_progress"},"trackingUrl":{"type":"string","format":"uri","description":"The application's page in GetMattered, behind the account owner's sign-in.","example":"https://getmattered.com/dashboard/applications/2481"}},"required":["id","status","trackingUrl"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperAtsScore":{"type":"object","properties":{"overallScore":{"type":"number","minimum":0,"maximum":100,"description":"Overall ATS compatibility score (0-100).","example":72},"keywordMatches":{"type":"array","items":{"type":"string"},"description":"Keywords found in the resume that match the job description.","example":["JavaScript","React","Node.js"]},"missingKeywords":{"type":"array","items":{"type":"string"},"description":"Important keywords from the job description missing from the resume.","example":["TypeScript","GraphQL"]},"sectionScores":{"$ref":"#/components/schemas/AtsSectionScores"},"suggestions":{"type":"array","items":{"type":"string"},"description":"Actionable improvement suggestions.","example":["Add \"TypeScript\" to your skills section."]}},"required":["overallScore","keywordMatches","missingKeywords","sectionScores","suggestions"],"additionalProperties":false,"description":"The ATS score of the tailored resume."},"DeveloperAtsScoreRequest":{"type":"object","properties":{"jobDescription":{"type":"string","minLength":50,"maxLength":50000,"description":"The job posting to score against. Omit it for general ATS compatibility.","example":"We are hiring a Senior Frontend Engineer with React, TypeScript and GraphQL experience to own our design system..."},"resumeText":{"type":"string","minLength":50,"maxLength":50000,"description":"The resume as plain text or Markdown, 50 to 50,000 characters.","example":"Jane Doe\nSenior Software Engineer\n6 years building React and TypeScript apps at Acme. Led the move to Next.js..."}},"required":["resumeText"],"additionalProperties":false},"DeveloperAtsScoreResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"overallScore":{"type":"number","minimum":0,"maximum":100,"description":"Overall ATS compatibility score (0-100).","example":72},"keywordMatches":{"type":"array","items":{"type":"string"},"description":"Keywords found in the resume that match the job description.","example":["JavaScript","React","Node.js"]},"missingKeywords":{"type":"array","items":{"type":"string"},"description":"Important keywords from the job description missing from the resume.","example":["TypeScript","GraphQL"]},"sectionScores":{"$ref":"#/components/schemas/AtsSectionScores"},"suggestions":{"type":"array","items":{"type":"string"},"description":"Actionable improvement suggestions.","example":["Add \"TypeScript\" to your skills section."]},"usage":{"$ref":"#/components/schemas/DeveloperCallUsage"}},"required":["overallScore","keywordMatches","missingKeywords","sectionScores","suggestions","usage"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperBalanceResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"balance":{"type":"integer","description":"The API tokens the account can spend now. Below zero after a running application finished past the end of the balance; the next call is refused until a top-up.","example":1250000},"currency":{"type":"string","enum":["tokens"]}},"required":["balance","currency"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperCallUsage":{"type":"object","properties":{"tokens":{"type":"integer","description":"The tokens this call spent from the key owner's account: the work it ran plus the request fee.","example":450}},"required":["tokens"],"additionalProperties":false},"DeveloperCoverLetterRequest":{"type":"object","properties":{"candidateName":{"type":"string","minLength":1,"maxLength":200,"description":"The name the letter is signed with. Omit it to use the name on the resume.","example":"Jane Doe"},"companyName":{"type":"string","minLength":1,"maxLength":200,"description":"The hiring company.","example":"Acme"},"jobDescription":{"type":"string","minLength":50,"maxLength":50000,"description":"The job posting text, 50 to 50,000 characters.","example":"We are hiring a Senior Frontend Engineer with React, TypeScript and GraphQL experience to own our design system..."},"jobTitle":{"type":"string","minLength":1,"maxLength":200,"description":"The job title of the posting.","example":"Senior Frontend Engineer"},"resumeText":{"type":"string","minLength":50,"maxLength":50000,"description":"The resume as plain text or Markdown, 50 to 50,000 characters.","example":"Jane Doe\nSenior Software Engineer\n6 years building React and TypeScript apps at Acme. Led the move to Next.js..."}},"required":["companyName","jobDescription","jobTitle","resumeText"],"additionalProperties":false},"DeveloperCoverLetterResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"coverLetter":{"type":"string","description":"The cover letter, plain text."},"keyThemes":{"type":"array","items":{"type":"string"},"description":"The themes the letter leads with.","example":["Design systems"]},"usage":{"$ref":"#/components/schemas/DeveloperCallUsage"}},"required":["coverLetter","keyThemes","usage"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperCvPackRequest":{"type":"object","properties":{"jobDescription":{"type":"string","minLength":50,"maxLength":50000,"description":"The job posting text, 50 to 50,000 characters.","example":"We are hiring a Senior Frontend Engineer with React, TypeScript and GraphQL experience to own our design system..."},"jobTitle":{"type":"string","minLength":1,"maxLength":200,"description":"The job title of the posting.","example":"Senior Frontend Engineer"},"resumeText":{"type":"string","minLength":50,"maxLength":50000,"description":"The resume as plain text or Markdown, 50 to 50,000 characters.","example":"Jane Doe\nSenior Software Engineer\n6 years building React and TypeScript apps at Acme. Led the move to Next.js..."},"tier":{"type":"string","enum":["light","pro"],"default":"light","description":"Tailoring depth. `light` is a quick rewrite, `pro` a deeper rewrite.","example":"light"}},"required":["jobDescription","jobTitle","resumeText"],"additionalProperties":false},"DeveloperCvPackResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/DeveloperAtsScore"},"before":{"allOf":[{"$ref":"#/components/schemas/DeveloperAtsScore"},{"description":"The ATS score of the resume as sent."}]},"keywordsAdded":{"type":"array","items":{"type":"string"},"description":"Posting keywords the tailored resume now carries.","example":["GraphQL"]},"summary":{"type":["string","null"],"description":"What the tailoring emphasized and why.","example":"Moved the design-system work to the top."},"tailoredResume":{"type":"string","description":"The tailored resume, Markdown."},"tier":{"type":"string","enum":["light","pro"],"description":"Tailoring depth. `light` is a quick rewrite, `pro` a deeper rewrite.","example":"light"},"parsed":{"$ref":"#/components/schemas/DeveloperParsedResume"},"usage":{"$ref":"#/components/schemas/DeveloperCallUsage"}},"required":["after","before","keywordsAdded","summary","tailoredResume","tier","parsed","usage"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperJob":{"type":"object","properties":{"canSend":{"type":"boolean","description":"True when GetMattered can send an application for this match. False for a job it cannot send, such as a job-board posting with no employer posting GetMattered sends on.","example":true},"company":{"type":["string","null"]},"companyLogoUrl":{"type":["string","null"]},"description":{"type":["string","null"]},"extractedSkills":{"type":["array","null"],"items":{"type":"string"}},"id":{"type":"integer"},"jobType":{"type":["string","null"]},"location":{"type":["string","null"]},"matchScore":{"type":["number","null"]},"postedAt":{"type":["string","null"]},"salary":{"type":["string","null"]},"salaryCurrency":{"type":["string","null"],"description":"ISO-4217 currency code of the original (pre-normalization) salary range (USD, EUR, GBP, ...). Null when no salary was reported.","example":"USD"},"salaryMaxUsd":{"type":["integer","null"],"description":"Upper bound of the listing salary range normalized to USD/year. Null when no parseable salary range exists.","example":180000},"salaryMinUsd":{"type":["integer","null"],"description":"Lower bound of the listing salary range normalized to USD/year. Null when no parseable salary range exists.","example":120000},"title":{"type":"string"},"url":{"type":"string"},"visaSponsorship":{"type":["string","null"]},"whyGoodFit":{"type":["string","null"],"description":"Enrichment-v2: one-paragraph (<=280 chars) neutral third-person blurb describing why a generic candidate might want this role. Null when the description is too thin.","example":"Remote-first Series B fintech with strong mentorship, modern TypeScript stack, and paid conference budget. Limited on-call and a small team where individual impact is high."},"workArrangement":{"type":["string","null"],"description":"Canonical work-arrangement enum (remote_global / remote_country / remote_region / hybrid / onsite / unknown). Drives the \"Remote\" chip + filter. Null only when enrichment hasn't run yet.","example":"remote_global"}},"required":["company","companyLogoUrl","description","extractedSkills","id","jobType","location","matchScore","postedAt","salary","salaryCurrency","salaryMaxUsd","salaryMinUsd","title","url","visaSponsorship","whyGoodFit","workArrangement"]},"DeveloperJobResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DeveloperJob"},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperJobSearchResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DeveloperJobSearchResult"},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperJobSearchResult":{"type":"object","properties":{"countries":{"type":"array","items":{"type":"string","enum":["ae","ar","at","au","bd","be","bh","bo","br","ca","ch","cl","cn","co","cr","cu","cz","de","dk","do","ec","eg","es","fi","fr","gr","gt","hk","hn","hu","id","ie","il","in","ir","it","jp","ke","kr","kw","lu","mx","my","ng","ni","nl","no","nz","om","pa","pe","ph","pk","pl","pr","pt","py","qa","ro","ru","sa","sd","se","sg","sv","tr","ua","ug","uk","us","uy","ve","vn","za","xx"],"description":"ISO-3166-1 alpha-2 country code (xx = unknown)","example":"de"},"description":"The countries the search read"},"jobs":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperSearchedJob"},"maxItems":10},"outcome":{"type":"string","enum":["found","none_found","no_query","no_place","no_remote_country"],"description":"What the job search found: jobs, none, or why it could not search","example":"found"},"titles":{"type":"array","items":{"type":"string"},"description":"The job titles the search read"}},"required":["countries","jobs","outcome","titles"]},"DeveloperLimitReached":{"type":"object","properties":{"error":{"type":"string","enum":["limit_reached"]},"limit":{"type":"object","properties":{"action":{"type":"string","enum":["ai_tokens"]},"current":{"type":"integer","description":"The tokens the account could spend.","example":0},"max":{"type":"integer","description":"The tokens the call needed to start.","example":560},"period":{"type":"string","enum":["balance"]},"planTier":{"type":["string","null"],"description":"Always null: API calls spend the API balance, never a plan.","example":null}},"required":["action","current","max","period","planTier"],"additionalProperties":false},"message":{"type":"string","example":"This account is out of API tokens. Buy API tokens at https://getmattered.com/dashboard/developers#api-balance, then call again."},"success":{"type":"boolean","enum":[false]}},"required":["error","limit","message","success"],"additionalProperties":false},"DeveloperMatch":{"type":"object","properties":{"company":{"type":["string","null"],"example":"Acme"},"id":{"type":"integer","exclusiveMinimum":0,"description":"The match. `POST /developer/apply` takes its `postingUrl`.","example":90412},"location":{"type":["string","null"],"example":"Berlin, Germany"},"matchScore":{"type":["number","null"],"description":"How well the job fits the candidate, 0 to 100.","example":86},"postedDate":{"type":["string","null"],"description":"When the employer posted it, as the source wrote it.","example":"2026-11-17"},"postingUrl":{"type":"string","example":"https://job-boards.greenhouse.io/acme/jobs/4012345"},"title":{"type":"string","example":"Senior Frontend Engineer"},"workArrangement":{"type":["string","null"],"enum":["onsite","hybrid","remote_local","remote_country","remote_region","remote_global","unknown",null],"description":"How a job can be performed geographically","example":"remote_country"}},"required":["company","id","location","matchScore","postedDate","postingUrl","title","workArrangement"],"additionalProperties":false},"DeveloperMatchListResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"hasMore":{"type":"boolean","description":"True when the next page holds more matches."},"matches":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperMatch"}},"page":{"type":"integer","example":1},"preferencesMissing":{"type":"boolean","description":"True when the candidate saved no job preferences yet: the deck is empty until `PUT /developer/preferences`."}},"required":["hasMore","matches","page","preferencesMissing"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperNotApplied":{"type":"object","properties":{"outcome":{"type":"string","enum":["not_applied"]},"reason":{"type":"string","enum":["unsupported_host","posting_not_found","import_failed","already_applied","no_employer_posting","account_only_board"],"description":"Why nothing was sent. `unsupported_host`: GetMattered does not apply on that hiring system. `posting_not_found`: the employer has no open posting at that link. `import_failed`: the posting could not be read. `already_applied`: this job already has an application. `no_employer_posting`: the job-board posting was read and no employer posting GetMattered applies on was found. `account_only_board`: the employer takes this job only behind a job board's own account.","example":"unsupported_host"},"success":{"type":"boolean","enum":[false]}},"required":["outcome","reason","success"],"additionalProperties":false},"DeveloperParsedResume":{"type":"object","properties":{"addressLine1":{"type":["string","null"],"description":"Street + number exactly as printed, or null","example":"Hauptstrasse 12"},"city":{"type":["string","null"],"description":"City from resume","example":"San Francisco"},"companySize":{"type":"array","items":{"type":"string"},"description":"AI-inferred company size preferences: startup, small, medium, large, enterprise","example":["startup","medium"]},"country":{"type":["string","null"],"description":"Country from resume","example":"United States"},"currentJobTitle":{"type":["string","null"],"description":"Current or most recent job title","example":"Senior Software Engineer"},"education":{"type":"array","items":{"$ref":"#/components/schemas/EducationItem"},"description":"Education history extracted from resume"},"educationLevel":{"type":["string","null"],"description":"AI-inferred education level: high_school, associate, bachelor, master, doctorate","example":"bachelor"},"email":{"type":["string","null"],"description":"Email address from resume","example":"john.doe@example.com"},"experienceLevel":{"type":["string","null"],"description":"AI-inferred experience level: entry, mid, senior, lead, executive","example":"senior"},"fieldEvidence":{"type":"array","items":{"$ref":"#/components/schemas/ResumeFieldEvidence"},"description":"Verbatim quotes from the resume that back the contact and level facts"},"firstName":{"type":["string","null"],"description":"First name parsed from full name","example":"John"},"fullName":{"type":["string","null"],"description":"Full name from resume","example":"John Doe"},"githubUrl":{"type":["string","null"],"description":"GitHub profile URL exactly as printed, or null","example":"https://github.com/johndoe"},"industries":{"type":"array","items":{"type":"string"},"description":"AI-inferred industries from work history","example":["Software & SaaS","AI & Machine Learning"]},"jobTypes":{"type":"array","items":{"type":"string"},"description":"AI-inferred job types: full_time, part_time, contract, freelance, internship, temporary","example":["full_time"]},"lastName":{"type":["string","null"],"description":"Last name parsed from full name","example":"Doe"},"linkedinUrl":{"type":["string","null"],"description":"LinkedIn profile URL exactly as printed, or null","example":"https://www.linkedin.com/in/johndoe"},"phone":{"type":["string","null"],"description":"Phone number from resume","example":"+1-555-123-4567"},"portfolioUrl":{"type":["string","null"],"description":"Personal website / portfolio URL exactly as printed, or null","example":"https://johndoe.dev"},"prefill":{"$ref":"#/components/schemas/ResumePrefill"},"professionalSummary":{"type":["string","null"],"description":"Professional summary or objective","example":"Experienced full-stack engineer with 8 years building scalable web applications."},"skills":{"type":"array","items":{"type":"string"},"description":"Skills extracted from resume","example":["TypeScript","React","Node.js","PostgreSQL"]},"state":{"type":["string","null"],"description":"State/province from resume","example":"California"},"suggestedJobTitles":{"type":"array","items":{"type":"string"},"description":"Suggested job titles based on experience","example":["Senior Software Engineer","Full Stack Developer","Tech Lead"]},"suggestedLocations":{"type":"array","items":{"type":"string"},"description":"Suggested job search locations based on resume","example":["San Francisco, CA","Remote"]},"workExperience":{"type":"array","items":{"$ref":"#/components/schemas/WorkExperienceItem"},"description":"Work experience history extracted from resume"},"yearsOfExperience":{"type":["integer","null"],"description":"Estimated total years of experience (whole number)","example":8},"zipCode":{"type":["string","null"],"description":"ZIP/postal code from resume","example":"94105"}},"required":["city","companySize","country","currentJobTitle","education","educationLevel","email","experienceLevel","firstName","fullName","industries","jobTypes","lastName","phone","professionalSummary","skills","state","suggestedJobTitles","suggestedLocations","workExperience","yearsOfExperience","zipCode"],"additionalProperties":false},"DeveloperParseRequest":{"type":"object","properties":{"resumeText":{"type":"string","minLength":50,"maxLength":50000,"description":"The resume as plain text or Markdown, 50 to 50,000 characters.","example":"Jane Doe\nSenior Software Engineer\n6 years building React and TypeScript apps at Acme. Led the move to Next.js..."}},"required":["resumeText"],"additionalProperties":false},"DeveloperParseResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"addressLine1":{"type":["string","null"],"description":"Street + number exactly as printed, or null","example":"Hauptstrasse 12"},"city":{"type":["string","null"],"description":"City from resume","example":"San Francisco"},"companySize":{"type":"array","items":{"type":"string"},"description":"AI-inferred company size preferences: startup, small, medium, large, enterprise","example":["startup","medium"]},"country":{"type":["string","null"],"description":"Country from resume","example":"United States"},"currentJobTitle":{"type":["string","null"],"description":"Current or most recent job title","example":"Senior Software Engineer"},"education":{"type":"array","items":{"$ref":"#/components/schemas/EducationItem"},"description":"Education history extracted from resume"},"educationLevel":{"type":["string","null"],"description":"AI-inferred education level: high_school, associate, bachelor, master, doctorate","example":"bachelor"},"email":{"type":["string","null"],"description":"Email address from resume","example":"john.doe@example.com"},"experienceLevel":{"type":["string","null"],"description":"AI-inferred experience level: entry, mid, senior, lead, executive","example":"senior"},"fieldEvidence":{"type":"array","items":{"$ref":"#/components/schemas/ResumeFieldEvidence"},"description":"Verbatim quotes from the resume that back the contact and level facts"},"firstName":{"type":["string","null"],"description":"First name parsed from full name","example":"John"},"fullName":{"type":["string","null"],"description":"Full name from resume","example":"John Doe"},"githubUrl":{"type":["string","null"],"description":"GitHub profile URL exactly as printed, or null","example":"https://github.com/johndoe"},"industries":{"type":"array","items":{"type":"string"},"description":"AI-inferred industries from work history","example":["Software & SaaS","AI & Machine Learning"]},"jobTypes":{"type":"array","items":{"type":"string"},"description":"AI-inferred job types: full_time, part_time, contract, freelance, internship, temporary","example":["full_time"]},"lastName":{"type":["string","null"],"description":"Last name parsed from full name","example":"Doe"},"linkedinUrl":{"type":["string","null"],"description":"LinkedIn profile URL exactly as printed, or null","example":"https://www.linkedin.com/in/johndoe"},"phone":{"type":["string","null"],"description":"Phone number from resume","example":"+1-555-123-4567"},"portfolioUrl":{"type":["string","null"],"description":"Personal website / portfolio URL exactly as printed, or null","example":"https://johndoe.dev"},"prefill":{"$ref":"#/components/schemas/ResumePrefill"},"professionalSummary":{"type":["string","null"],"description":"Professional summary or objective","example":"Experienced full-stack engineer with 8 years building scalable web applications."},"skills":{"type":"array","items":{"type":"string"},"description":"Skills extracted from resume","example":["TypeScript","React","Node.js","PostgreSQL"]},"state":{"type":["string","null"],"description":"State/province from resume","example":"California"},"suggestedJobTitles":{"type":"array","items":{"type":"string"},"description":"Suggested job titles based on experience","example":["Senior Software Engineer","Full Stack Developer","Tech Lead"]},"suggestedLocations":{"type":"array","items":{"type":"string"},"description":"Suggested job search locations based on resume","example":["San Francisco, CA","Remote"]},"workExperience":{"type":"array","items":{"$ref":"#/components/schemas/WorkExperienceItem"},"description":"Work experience history extracted from resume"},"yearsOfExperience":{"type":["integer","null"],"description":"Estimated total years of experience (whole number)","example":8},"zipCode":{"type":["string","null"],"description":"ZIP/postal code from resume","example":"94105"},"usage":{"$ref":"#/components/schemas/DeveloperCallUsage"}},"required":["city","companySize","country","currentJobTitle","education","educationLevel","email","experienceLevel","firstName","fullName","industries","jobTypes","lastName","phone","professionalSummary","skills","state","suggestedJobTitles","suggestedLocations","workExperience","yearsOfExperience","zipCode","usage"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperProfile":{"type":"object","properties":{"addressLine1":{"type":["string","null"],"description":"Address line 1","example":"123 Main St"},"addressLine2":{"type":["string","null"],"description":"Address line 2","example":"Apt 4B"},"city":{"type":["string","null"],"description":"City","example":"San Francisco"},"country":{"type":["string","null"],"description":"Country","example":"US"},"githubUrl":{"type":["string","null"],"description":"GitHub profile URL","example":"https://github.com/johndoe"},"linkedinUrl":{"type":["string","null"],"description":"LinkedIn profile URL","example":"https://linkedin.com/in/johndoe"},"phone":{"type":["string","null"],"description":"Phone number","example":"+1-555-123-4567"},"portfolioUrl":{"type":["string","null"],"description":"Portfolio website URL","example":"https://johndoe.dev"},"relocationLocations":{"type":["array","null"],"items":{"type":"string"},"description":"Preferred relocation locations as \"City, Country\" or \"Country\". Middle admin segments stripped on read.","example":["New York, United States","Austin, United States"]},"state":{"type":["string","null"],"description":"State or province","example":"CA"},"willingToRelocate":{"type":"boolean","description":"Willing to relocate for a job","example":false},"workAuthorization":{"type":["string","null"],"enum":["us_citizen","permanent_resident","visa_holder","require_sponsorship","other",null],"description":"Work authorization status","example":"us_citizen"},"zipCode":{"type":["string","null"],"description":"ZIP or postal code","example":"94105"},"email":{"type":"string","description":"The account email. Read-only here.","example":"jane@example.com"},"name":{"type":["string","null"],"description":"The candidate's full name.","example":"Jane Doe"}},"required":["addressLine1","addressLine2","city","country","githubUrl","linkedinUrl","phone","portfolioUrl","relocationLocations","state","willingToRelocate","workAuthorization","zipCode","email","name"]},"DeveloperProfileResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DeveloperProfile"},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperProfileUpdate":{"type":"object","properties":{"addressLine1":{"type":["string","null"],"maxLength":255,"description":"Address line 1","example":"123 Main St"},"addressLine2":{"type":["string","null"],"maxLength":255,"description":"Address line 2","example":"Apt 4B"},"city":{"type":["string","null"],"maxLength":100,"description":"City","example":"San Francisco"},"country":{"type":["string","null"],"maxLength":100,"description":"Country","example":"US"},"githubUrl":{"type":["string","null"],"maxLength":500,"format":"uri","description":"GitHub profile URL","example":"https://github.com/johndoe"},"linkedinUrl":{"type":["string","null"],"maxLength":500,"format":"uri","description":"LinkedIn profile URL","example":"https://linkedin.com/in/johndoe"},"phone":{"type":["string","null"],"maxLength":20,"description":"Phone number","example":"+1-555-123-4567"},"portfolioUrl":{"type":["string","null"],"maxLength":500,"format":"uri","description":"Portfolio website URL","example":"https://johndoe.dev"},"relocationLocations":{"type":["array","null"],"items":{"type":"string"},"description":"Preferred relocation locations as \"City, Country\" or \"Country\" (max per-entry stripping of middle admin segments on ingest).","example":["New York, United States","Austin, United States"]},"state":{"type":["string","null"],"maxLength":100,"description":"State or province","example":"CA"},"willingToRelocate":{"type":"boolean","description":"Willing to relocate for a job","example":false},"workAuthorization":{"type":["string","null"],"enum":["us_citizen","permanent_resident","visa_holder","require_sponsorship","other",null],"description":"Work authorization status","example":"us_citizen"},"zipCode":{"type":["string","null"],"maxLength":20,"description":"ZIP or postal code","example":"94105"},"name":{"type":"string","minLength":1,"maxLength":100,"description":"The candidate's full name, as employers see it.","example":"Jane Doe"}},"additionalProperties":false},"DeveloperResume":{"type":"object","properties":{"id":{"type":"integer","description":"The resume document.","example":512},"mimeType":{"type":["string","null"],"description":"The stored file type.","example":"application/pdf"},"text":{"type":["string","null"],"description":"The resume as text, when GetMattered read it. Null while a new upload is still being read.","example":"Jane Doe\nSenior Software Engineer..."},"title":{"type":"string","example":"Jane Doe resume"}},"required":["id","mimeType","text","title"],"additionalProperties":false},"DeveloperResumeResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DeveloperResume"},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperResumeUpload":{"type":"object","properties":{"id":{"type":"integer","description":"The resume document.","example":512},"mimeType":{"type":["string","null"],"description":"The stored file type.","example":"application/pdf"},"text":{"type":["string","null"],"description":"The resume as text, as GetMattered read it from the file. Null when it found no readable text.","example":"Jane Doe\nSenior Software Engineer..."},"title":{"type":"string","example":"Jane Doe resume"},"status":{"type":"string","enum":["draft","generating","ready","failed"],"description":"`ready`: the resume is stored and read; `text` holds what GetMattered read, and is null when the file had no readable text (applications still send the file). `failed`: GetMattered could not read the file. `GET /developer/resume` answers the same resume afterwards.","example":"ready"},"usage":{"$ref":"#/components/schemas/DeveloperCallUsage"}},"required":["id","mimeType","text","title","status","usage"],"additionalProperties":false},"DeveloperResumeUploadForm":{"type":"object","properties":{"file":{"type":"string","description":"The resume file: PDF, DOCX, ODT, RTF, TXT or MD, at most 10 MB.","format":"binary"}},"required":["file"]},"DeveloperResumeUploadResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DeveloperResumeUpload"},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperSearchedJob":{"type":"object","properties":{"company":{"type":"string","example":"Ramp"},"jobMatchId":{"type":["integer","null"],"exclusiveMinimum":0,"description":"The candidate's own match for this job, when there is one: `GET /developer/jobs/{id}` reads it.","example":90412},"jobUrl":{"type":"string","description":"The employer's own posting. `POST /developer/apply` takes it as `postingUrl`.","example":"https://jobs.ashbyhq.com/acme/1f2e3d4c"},"location":{"type":["string","null"]},"postedDate":{"type":["string","null"],"description":"When the employer posted it, as the source wrote it"},"remote":{"type":"boolean"},"salaryMaxUsd":{"type":["integer","null"]},"salaryMinUsd":{"type":["integer","null"]},"system":{"type":"string","description":"The hiring system name a person reads","example":"Ashby"},"title":{"type":"string","example":"Founding Engineer"}},"required":["company","jobMatchId","jobUrl","location","postedDate","remote","salaryMaxUsd","salaryMinUsd","system","title"]},"DeveloperTailorRequest":{"type":"object","properties":{"jobDescription":{"type":"string","minLength":50,"maxLength":50000,"description":"The job posting text, 50 to 50,000 characters.","example":"We are hiring a Senior Frontend Engineer with React, TypeScript and GraphQL experience to own our design system..."},"jobTitle":{"type":"string","minLength":1,"maxLength":200,"description":"The job title of the posting.","example":"Senior Frontend Engineer"},"resumeText":{"type":"string","minLength":50,"maxLength":50000,"description":"The resume as plain text or Markdown, 50 to 50,000 characters.","example":"Jane Doe\nSenior Software Engineer\n6 years building React and TypeScript apps at Acme. Led the move to Next.js..."},"tier":{"type":"string","enum":["light","pro"],"default":"light","description":"Tailoring depth. `light` is a quick rewrite, `pro` a deeper rewrite.","example":"light"}},"required":["jobDescription","jobTitle","resumeText"],"additionalProperties":false},"DeveloperTailorResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"after":{"$ref":"#/components/schemas/DeveloperAtsScore"},"before":{"allOf":[{"$ref":"#/components/schemas/DeveloperAtsScore"},{"description":"The ATS score of the resume as sent."}]},"keywordsAdded":{"type":"array","items":{"type":"string"},"description":"Posting keywords the tailored resume now carries.","example":["GraphQL"]},"summary":{"type":["string","null"],"description":"What the tailoring emphasized and why.","example":"Moved the design-system work to the top."},"tailoredResume":{"type":"string","description":"The tailored resume, Markdown."},"tier":{"type":"string","enum":["light","pro"],"description":"Tailoring depth. `light` is a quick rewrite, `pro` a deeper rewrite.","example":"light"},"usage":{"$ref":"#/components/schemas/DeveloperCallUsage"}},"required":["after","before","keywordsAdded","summary","tailoredResume","tier","usage"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperUsage":{"type":"object","properties":{"keys":{"type":"array","items":{"type":"object","properties":{"calls":{"type":"integer","description":"Calls this month, every outcome.","example":120},"failedCalls":{"type":"integer","description":"Calls whose work started and failed on our side.","example":1},"keyId":{"type":"integer","example":3},"keyPrefix":{"type":"string","description":"The first characters of the key.","example":"gm_live_AbCd"},"name":{"type":"string","example":"Production"},"operations":{"type":"array","items":{"type":"object","properties":{"calls":{"type":"integer","example":100},"operation":{"type":"string","enum":["ats_score","parse","analyze_job","light_cv_pack","pro_cv_pack","cover_letter","apply","read_profile","update_profile","read_resume","read_preferences","update_preferences","search_jobs","read_matches","read_job","list_applications","approve_application","cancel_application","manage_webhooks"],"description":"What a developer API call does. A call that runs AI work spends the tokens it used plus a flat request fee; a read, an edit, an approval and a webhook change spend nothing.","example":"ats_score"},"tokens":{"type":"integer","example":45000}},"required":["calls","operation","tokens"],"additionalProperties":false}},"refusedCalls":{"type":"integer","description":"Calls declined before any spend: no tokens, a plan limit, or a posting GetMattered cannot apply to.","example":0},"tokens":{"type":"integer","description":"Tokens these calls spent this month.","example":61400}},"required":["calls","failedCalls","keyId","keyPrefix","name","operations","refusedCalls","tokens"],"additionalProperties":false}},"month":{"type":"string","pattern":"^\\d{4}-(?:0[1-9]|1[0-2])$","description":"Calendar month in UTC, `YYYY-MM`.","example":"2026-11"}},"required":["keys","month"],"additionalProperties":false},"DeveloperUsageResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DeveloperUsage"},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperWebhookCreated":{"type":"object","properties":{"createdAt":{"type":"string","example":"2026-11-19 17:00:00"},"id":{"type":"integer","exclusiveMinimum":0,"description":"The webhook endpoint.","example":7},"secretPrefix":{"type":"string","description":"The first characters of the signing secret.","example":"whsec_AbCdEf"},"url":{"type":"string","example":"https://example.com/hooks/getmattered"},"secret":{"type":"string","description":"The signing secret. Shown once: store it now. Verify each delivery with it (see `GetMattered-Signature`).","example":"whsec_3q2-7wAbCdEfGhIjKlMnOpQrStUvWxYz0123456789"}},"required":["createdAt","id","secretPrefix","url","secret"],"additionalProperties":false},"DeveloperWebhookCreatedResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/DeveloperWebhookCreated"},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperWebhookCreateRequest":{"type":"object","properties":{"url":{"type":"string","maxLength":2048,"format":"uri","description":"Where GetMattered POSTs events. Public `https` only; redirects are not followed.","example":"https://example.com/hooks/getmattered"}},"required":["url"],"additionalProperties":false},"DeveloperWebhookDeletedResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"deleted":{"type":"boolean","enum":[true]},"id":{"type":"integer","exclusiveMinimum":0,"description":"The webhook endpoint.","example":7}},"required":["deleted","id"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperWebhookDeliveriesResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"deliveries":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperWebhookDelivery"}}},"required":["deliveries"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperWebhookDelivery":{"type":"object","properties":{"attempts":{"type":"integer","description":"Attempts made so far.","example":1},"createdAt":{"type":"string","example":"2026-11-19 17:01:00"},"deliveredAt":{"type":["string","null"],"example":"2026-11-19T17:01:02.000Z"},"eventId":{"type":"string","example":"evt_3f9c2a7d6b8e4f0a9c1d2e3f4a5b6c7d"},"eventType":{"type":"string","example":"application.landed"},"lastStatusCode":{"type":["integer","null"],"description":"The HTTP status your endpoint answered the last attempt with; null when it did not answer.","example":200},"status":{"type":"string","enum":["pending","delivered","failed"],"description":"`pending`: not delivered yet, another attempt is due. `delivered`: the endpoint answered 2xx. `failed`: every attempt failed; no more are made.","example":"delivered"}},"required":["attempts","createdAt","deliveredAt","eventId","eventType","lastStatusCode","status"],"additionalProperties":false},"DeveloperWebhookEndpoint":{"type":"object","properties":{"createdAt":{"type":"string","example":"2026-11-19 17:00:00"},"id":{"type":"integer","exclusiveMinimum":0,"description":"The webhook endpoint.","example":7},"secretPrefix":{"type":"string","description":"The first characters of the signing secret.","example":"whsec_AbCdEf"},"url":{"type":"string","example":"https://example.com/hooks/getmattered"}},"required":["createdAt","id","secretPrefix","url"],"additionalProperties":false},"DeveloperWebhookListResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"endpoints":{"type":"array","items":{"$ref":"#/components/schemas/DeveloperWebhookEndpoint"}}},"required":["endpoints"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"DeveloperWebhookTestResponse":{"type":"object","properties":{"data":{"type":"object","properties":{"eventId":{"type":"string","example":"evt_3f9c2a7d6b8e4f0a9c1d2e3f4a5b6c7d"},"queued":{"type":"boolean","enum":[true]}},"required":["eventId","queued"],"additionalProperties":false},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response"},"EducationItem":{"type":"object","properties":{"degree":{"type":"string","description":"Degree or certification name","example":"B.S. Computer Science"},"institution":{"type":"string","description":"School or institution name","example":"MIT"},"year":{"type":["string","null"],"description":"Graduation year or date range","example":"2018"}},"required":["degree","institution","year"],"additionalProperties":false},"JobMatchPreferencesData":{"type":"object","properties":{"benefits":{"type":["array","null"],"items":{"type":"string"}},"companySize":{"type":["array","null"],"items":{"type":"string"}},"createdAt":{"type":["string","null"]},"educationLevel":{"type":["string","null"]},"excludeIndustries":{"type":["array","null"],"items":{"type":"string"}},"experienceLevel":{"type":["string","null"]},"experienceLevels":{"type":["array","null"],"items":{"type":"string"}},"id":{"type":"integer"},"includeRemote":{"type":"boolean"},"industries":{"type":["array","null"],"items":{"type":"string"}},"isActive":{"type":"boolean"},"jobTypes":{"type":["array","null"],"items":{"type":"string"}},"locations":{"type":["array","null"],"items":{"type":"string"}},"remoteGlobal":{"type":"boolean"},"salaryCurrency":{"type":"string","enum":["usd","eur","gbp","cad","aud","inr"],"description":"Currency for salary values","example":"usd"},"salaryMax":{"type":["number","null"]},"salaryMin":{"type":["number","null"]},"skills":{"type":["array","null"],"items":{"type":"string"}},"targetRoles":{"type":["array","null"],"items":{"type":"string"}},"updatedAt":{"type":["string","null"]},"visaSponsorship":{"type":["string","null"]},"workStyles":{"type":"array","items":{"type":"string","enum":["onsite","hybrid","remote"],"description":"User's preferred work style, physical mode only, no geo scoping","example":"remote"}}},"required":["benefits","companySize","createdAt","educationLevel","excludeIndustries","experienceLevel","experienceLevels","id","includeRemote","industries","isActive","jobTypes","locations","remoteGlobal","salaryCurrency","salaryMax","salaryMin","skills","targetRoles","updatedAt","visaSponsorship","workStyles"]},"KeywordItem":{"type":"object","properties":{"term":{"type":"string","description":"Keyword or skill term","example":"React"},"category":{"type":"string","enum":["technical_skill","soft_skill","certification","tool","experience","education","industry_knowledge"],"description":"Category of the keyword","example":"technical_skill"},"importance":{"type":"integer","minimum":1,"maximum":10,"description":"Importance weight (1-10)","example":9}},"required":["term","category","importance"],"additionalProperties":false},"PreferencesResponse":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/PreferencesResponseData"},"meta":{"$ref":"#/components/schemas/ResponseMetadata"},"success":{"type":"boolean","enum":[true]}},"required":["data","success"],"additionalProperties":false,"description":"Successful API response","example":{"data":{"benefits":null,"companySize":["startup","medium"],"createdAt":"2026-09-01T12:00:00.000Z","educationLevel":"bachelor","excludeIndustries":null,"experienceLevel":"senior","experienceLevels":["senior"],"id":311,"includeRemote":true,"industries":["Software & SaaS","Financial Services"],"isActive":true,"jobTypes":["full_time"],"locations":["San Francisco, United States"],"remoteGlobal":false,"salaryCurrency":"usd","salaryMax":190000,"salaryMin":150000,"skills":["TypeScript","React","Node.js","PostgreSQL"],"targetRoles":["Senior Software Engineer","Full Stack Developer"],"updatedAt":"2026-09-20T08:30:00.000Z","visaSponsorship":null,"workStyles":["remote","hybrid"]},"success":true}},"PreferencesResponseData":{"allOf":[{"$ref":"#/components/schemas/JobMatchPreferencesData"},{"type":"object","properties":{"prefsChanged":{"type":"boolean","description":"PUT only. True when this save changed at least one job_match_preference column (always true when it created the row). False means nothing moved. Absent on GET.","example":true}}}]},"ResponseMetadata":{"type":"object","properties":{"duration":{"type":"number","minimum":0,"description":"Request duration in milliseconds","example":150},"performance":{"type":"object","properties":{"dbQueries":{"type":"integer","minimum":0},"totalDbTime":{"type":"number","minimum":0}},"description":"Performance metrics (preview/local only)"},"requestId":{"type":"string","description":"Unique request identifier","example":"req_abc123"},"timestamp":{"type":"string","format":"date-time","description":"ISO 8601 timestamp","example":"2026-11-17T12:00:00.000Z"},"version":{"type":"string","description":"API version","example":"v1"}}},"ResumeFieldEvidence":{"type":"object","properties":{"confidence":{"type":"string","enum":["high","medium","low"],"description":"How the value was read: high/medium when printed in the resume, low when inferred","example":"high"},"field":{"type":"string","enum":["addressLine1","city","state","country","zipCode","phone","email","linkedinUrl","githubUrl","portfolioUrl","currentEmployer","educationLevel"],"description":"A parsed resume fact backed by a verbatim quote from the resume","example":"city"},"quote":{"type":["string","null"],"description":"The exact contiguous resume text that contains the value (<=160 chars), or null","example":"Berlin, Germany | +49 176 1234 5678"}},"required":["confidence","field","quote"],"additionalProperties":false},"ResumePrefill":{"type":"object","properties":{"addressLine1":{"type":["string","null"]},"city":{"type":["string","null"]},"country":{"type":["string","null"]},"currentEmployer":{"type":["string","null"]},"githubUrl":{"type":["string","null"]},"highestEducation":{"type":["string","null"],"enum":["high_school","associate","bachelor","master","doctorate","any",null],"description":"Education level requirement","example":"any"},"homeLocation":{"type":["string","null"]},"linkedinUrl":{"type":["string","null"]},"ownTitles":{"type":"array","items":{"type":"string"}},"phone":{"type":["string","null"]},"portfolioUrl":{"type":["string","null"]},"seeded":{"type":"object","properties":{"jobPreferences":{"type":"object","properties":{"locations":{"type":"boolean","enum":[true]},"experienceLevels":{"type":"boolean","enum":[true]},"skills":{"type":"boolean","enum":[true]},"targetRoles":{"type":"boolean","enum":[true]}}},"profile":{"type":"object","properties":{"addressLine1":{"type":"boolean","enum":[true]},"city":{"type":"boolean","enum":[true]},"state":{"type":"boolean","enum":[true]},"country":{"type":"boolean","enum":[true]},"zipCode":{"type":"boolean","enum":[true]},"phone":{"type":"boolean","enum":[true]},"linkedinUrl":{"type":"boolean","enum":[true]},"githubUrl":{"type":"boolean","enum":[true]},"portfolioUrl":{"type":"boolean","enum":[true]},"currentEmployer":{"type":"boolean","enum":[true]},"highestEducation":{"type":"boolean","enum":[true]},"yearsOfExperience":{"type":"boolean","enum":[true]}}}},"additionalProperties":false},"state":{"type":["string","null"]},"workHistoryLocations":{"type":"array","items":{"type":"string"}},"yearsOfExperience":{"type":["integer","null"]},"zipCode":{"type":["string","null"]}},"required":["addressLine1","city","country","currentEmployer","githubUrl","highestEducation","homeLocation","linkedinUrl","ownTitles","phone","portfolioUrl","state","workHistoryLocations","yearsOfExperience","zipCode"],"additionalProperties":false},"UpdatePreferencesRequest":{"type":"object","properties":{"benefits":{"type":"array","items":{"type":"string"},"description":"Must-have job benefits","example":["health_insurance","remote_work"]},"companySize":{"type":"array","items":{"type":"string"},"description":"Preferred company sizes","example":["startup","small"]},"educationLevel":{"type":"string","description":"Minimum education level filter","example":"bachelor"},"excludeIndustries":{"type":"array","items":{"type":"string"},"description":"Industries to exclude from matches","example":["Government & Public Sector"]},"experienceLevel":{"type":"string","enum":["intern","entry","junior","mid","senior","lead","executive"],"description":"Target experience level (DEPRECATED scalar  -  prefer `experienceLevels`). When `experienceLevels` is present it wins; this scalar is kept so legacy mobile binaries keep working.","example":"senior"},"experienceLevels":{"type":"array","items":{"type":"string","enum":["intern","entry","junior","mid","senior","lead","executive"],"description":"Professional experience level","example":"mid"},"description":"Target experience levels (multi-select, new source of truth). Empty/omitted = no seniority constraint. The first element is mirrored into the deprecated scalar `experienceLevel`.","example":["mid","senior"]},"includeRemote":{"type":"boolean","description":"Include region-restricted remote jobs (workStyles \"remote\") even when specific locations are set. Does NOT control worldwide remote  -  see `remoteGlobal`.","example":true},"remoteGlobal":{"type":"boolean","description":"Accept worldwide \"Remote  -  Anywhere (Global)\" jobs from any region. Independent of `includeRemote`/workStyles \"remote\" (which stay region-restricted). Set via the \"Remote  -  Anywhere (Global)\" option in the location picker.","example":false},"industries":{"type":"array","items":{"type":"string"},"description":"Target industries","example":["Technology","Finance"]},"isActive":{"type":"boolean","description":"Enable or disable daily matches","example":true},"jobTypes":{"type":"array","items":{"type":"string"},"description":"Preferred job types","example":["full_time","contract"]},"locations":{"type":"array","items":{"type":"string"},"maxItems":5,"description":"Preferred locations as \"City, Country\" or \"Country\" (max 5). Middle admin segments (state/province) are stripped on ingest. Placeholder values (\"anywhere\", \"any\", ...) are rejected for security (they disable location scoping and let clients harvest the full job pool). An empty array is accepted ONLY for a caller opted into `remoteGlobal` - worldwide remote is itself the location answer.","example":["San Francisco, United States","Berlin, Germany"]},"salaryCurrency":{"type":"string","enum":["usd","eur","gbp","cad","aud","inr"],"description":"Currency for the salary band (converted to USD for matching). Defaults to usd.","example":"eur"},"salaryMax":{"type":"number","minimum":0,"description":"Maximum salary requirement","example":200000},"salaryMin":{"type":"number","minimum":0,"description":"Minimum salary requirement","example":100000},"skills":{"type":"array","items":{"type":"string"},"description":"User skills (from resume or manual entry)","example":["TypeScript","React","Node.js","PostgreSQL"]},"targetRoles":{"type":"array","items":{"type":"string","maxLength":200},"minItems":1,"maxItems":5,"description":"Target role titles (max 5). When present, at least one specific title is required  -  empty arrays and placeholder values (\"anywhere\", \"any\", ...) are rejected for security (they disable role scoping and let clients harvest the full job pool).","example":["Software Engineer","Full Stack Developer"]},"visaSponsorship":{"type":"string","description":"Visa sponsorship preference","example":"required"},"workStyles":{"type":"array","items":{"type":"string","enum":["onsite","hybrid","remote"],"description":"User's preferred work style, physical mode only, no geo scoping","example":"remote"},"minItems":1,"description":"Preferred work styles (onsite/hybrid/remote)  -  multi-select, at least 1 required. Geo scoping is inferred from `locations`, NOT this field.","example":["remote","hybrid"]}},"additionalProperties":false,"example":{"locations":["San Francisco, United States"],"salaryCurrency":"usd","salaryMax":190000,"salaryMin":150000,"targetRoles":["Senior Software Engineer","Full Stack Developer"],"workStyles":["remote","hybrid"]}},"WorkExperienceItem":{"type":"object","properties":{"company":{"type":"string","description":"Company name","example":"Acme Corp"},"current":{"type":"boolean","description":"Whether this is the current position","example":false},"description":{"type":["string","null"],"description":"Role description or achievements","example":"Led a team of 5 engineers building microservices"},"endDate":{"type":["string","null"],"description":"End date (free-form from resume)","example":"Dec 2023"},"location":{"type":["string","null"],"description":"City of this role exactly as printed on the resume","example":"Berlin"},"startDate":{"type":["string","null"],"description":"Start date (free-form from resume)","example":"Jan 2020"},"title":{"type":"string","description":"Job title","example":"Senior Software Engineer"}},"required":["company","current","description","endDate","startDate","title"],"additionalProperties":false}},"securitySchemes":{"DeveloperKey":{"bearerFormat":"gm_live_...","description":"A GetMattered developer API key, sent as `Authorization: Bearer gm_live_...`.","scheme":"bearer","type":"http"}}},"info":{"contact":{"email":"support@getmattered.com","name":"GetMattered","url":"https://getmattered.com/docs"},"description":"Run a job search end to end for the account that owns the key: its profile, job preferences and resume, job search and matches, applications with the employer's confirmation, and signed webhooks when an application lands. Score, parse and tailor resumes and write cover letters. Calls that run AI work or send an application spend tokens from the account's API balance; reads, edits, approvals and webhooks are free.","license":{"name":"Proprietary","url":"https://getmattered.com/legal/terms"},"title":"GetMattered API","version":"v1"},"openapi":"3.1.0","paths":{"/developer/analyze-job":{"post":{"description":"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`.","security":[{"DeveloperKey":[]}],"summary":"Analyze a job posting","tags":["developer"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperAnalyzeJobRequest"}}}},"responses":{"200":{"description":"The posting keywords.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperAnalyzeJobResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"402":{"description":"The key owner's API balance has no tokens for this call. Nothing was spent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperLimitReached"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"postDeveloperAnalyzeJob"}},"/developer/applications":{"get":{"description":"Your applications, newest first, with the same states as `GET /developer/applications/{id}`. Filter by `status` and `since`; page with `cursor`. Free.","security":[{"DeveloperKey":[]}],"summary":"List applications","tags":["developer"],"parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"description":"The `nextCursor` of the page before. Omit it for the newest applications.","example":2480},"required":false,"description":"The `nextCursor` of the page before. Omit it for the newest applications.","name":"cursor","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Applications per page, 1 to 50.","example":20},"required":false,"description":"Applications per page, 1 to 50.","name":"limit","in":"query"},{"schema":{"type":"string","format":"date-time","description":"Only applications started at or after this instant, ISO 8601.","example":"2026-11-01T00:00:00Z"},"required":false,"description":"Only applications started at or after this instant, ISO 8601.","name":"since","in":"query"},{"schema":{"type":"string","enum":["in_progress","held_for_review","needs_you","landed","held","not_landed"],"description":"Only applications in this state. A filtered page may hold fewer items than `limit`; keep paging while `nextCursor` is not null.","example":"in_progress"},"required":false,"description":"Only applications in this state. A filtered page may hold fewer items than `limit`; keep paging while `nextCursor` is not null.","name":"status","in":"query"}],"responses":{"200":{"description":"One page of applications and the cursor for the next.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApplicationListResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getDeveloperApplications"}},"/developer/applications/{id}":{"get":{"description":"Where one of your applications stands. `landed` only when the employer confirmed it, by their own email or their confirmation page. Free.","security":[{"DeveloperKey":[]}],"summary":"Read an application","tags":["developer"],"parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"description":"The application id `POST /developer/apply` answered with.","example":2481},"required":true,"description":"The application id `POST /developer/apply` answered with.","in":"path","name":"id"}],"responses":{"200":{"description":"The application's status, the employer's proof and the tokens spent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApplicationResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getDeveloperApplicationsById"}},"/developer/applications/{id}/approve":{"post":{"description":"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.","security":[{"DeveloperKey":[]}],"summary":"Approve a held application","tags":["developer"],"parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"description":"The application id `POST /developer/apply` answered with.","example":2481},"required":true,"description":"The application id `POST /developer/apply` answered with.","in":"path","name":"id"}],"responses":{"200":{"description":"The application after the approval.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApplicationResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"postDeveloperApplicationsByIdApprove"}},"/developer/applications/{id}/cancel":{"post":{"description":"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.","security":[{"DeveloperKey":[]}],"summary":"Cancel an application","tags":["developer"],"parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"description":"The application id `POST /developer/apply` answered with.","example":2481},"required":true,"description":"The application id `POST /developer/apply` answered with.","in":"path","name":"id"}],"responses":{"200":{"description":"The application after the cancel.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApplicationResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"postDeveloperApplicationsByIdCancel"}},"/developer/apply":{"post":{"description":"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.","security":[{"DeveloperKey":[]}],"summary":"Apply to a job posting","tags":["developer"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"mode":{"type":"string","enum":["auto","review"],"description":"`auto` sends once the application is ready. `review` holds it for the account owner to approve in GetMattered. Omitted, the account's own setting decides, and `auto` never overrides an account set to review.","example":"auto"},"postingUrl":{"type":"string","maxLength":2048,"format":"uri","description":"The job posting to apply to: the employer's own posting, or a job-board link to it. GetMattered applies only on the hiring systems it supports.","example":"https://job-boards.greenhouse.io/acme/jobs/4012345"}},"required":["postingUrl"],"additionalProperties":false}}}},"responses":{"202":{"description":"The application, started now or found from an earlier call.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperApplyResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"402":{"description":"The key owner's API balance cannot start an application. Nothing was sent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperLimitReached"}}}},"403":{"description":"The key lacks the `apply` scope its owner grants at creation. Nothing was sent.","content":{"application/json":{"schema":{"anyOf":[{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string","enum":["limit_reached"]},"limit":{"type":"object","properties":{"action":{"type":"string"},"current":{"type":"number"},"max":{"type":"number"},"period":{"type":"string"},"planTier":{"type":["string","null"]},"reason":{"type":"string"}},"required":["action","current","max","period"]},"message":{"type":"string","minLength":1}},"required":["error","limit"]},{"$ref":"#/components/schemas/ApiErrorResponse"}]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"422":{"description":"GetMattered cannot apply to this posting; `reason` says why. Nothing was sent; the request fee was spent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperNotApplied"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"503":{"description":"Service Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"postDeveloperApply"}},"/developer/ats-score":{"post":{"description":"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`.","security":[{"DeveloperKey":[]}],"summary":"Score a resume for ATS compatibility","tags":["developer"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperAtsScoreRequest"}}}},"responses":{"200":{"description":"The ATS score, matched and missing keywords, section scores and suggestions.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperAtsScoreResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"402":{"description":"The key owner's API balance has no tokens for this call. Nothing was spent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperLimitReached"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"postDeveloperAtsScore"}},"/developer/balance":{"get":{"description":"The API tokens your account can spend now. API calls spend this balance, never your GetMattered plan. Free.","security":[{"DeveloperKey":[]}],"summary":"Read your API balance","tags":["developer"],"responses":{"200":{"description":"The API balance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperBalanceResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getDeveloperBalance"}},"/developer/cover-letter":{"post":{"description":"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`.","security":[{"DeveloperKey":[]}],"summary":"Write a cover letter","tags":["developer"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperCoverLetterRequest"}}}},"responses":{"200":{"description":"The cover letter and the themes it leads with.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperCoverLetterResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"402":{"description":"The key owner's API balance has no tokens for this call. Nothing was spent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperLimitReached"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"postDeveloperCoverLetter"}},"/developer/cv-pack":{"post":{"description":"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`.","security":[{"DeveloperKey":[]}],"summary":"Parse, score and tailor a resume in one call","tags":["developer"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperCvPackRequest"}}}},"responses":{"200":{"description":"The structured resume, the tailored resume and its before and after ATS scores.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperCvPackResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"402":{"description":"The key owner's API balance has no tokens for this call. Nothing was spent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperLimitReached"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"postDeveloperCvPack"}},"/developer/jobs/{id}":{"get":{"description":"One of the candidate's matches in full: description, pay, fit and whether GetMattered can apply to it (`canSend`). Free.","security":[{"DeveloperKey":[]}],"summary":"Read a job","tags":["developer"],"parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"description":"The match id from `GET /developer/jobs/matches` or a search `jobMatchId`.","example":90412},"required":true,"description":"The match id from `GET /developer/jobs/matches` or a search `jobMatchId`.","in":"path","name":"id"}],"responses":{"200":{"description":"The match.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperJobResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getDeveloperJobsById"}},"/developer/jobs/matches":{"get":{"description":"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.","security":[{"DeveloperKey":[]}],"summary":"List the candidate's matches","tags":["developer"],"parameters":[{"schema":{"type":"integer","minimum":1,"maximum":50,"default":20,"description":"Matches per page, 1 to 50.","example":20},"required":false,"description":"Matches per page, 1 to 50.","name":"limit","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":20,"default":1,"description":"The page, from 1 to 20.","example":1},"required":false,"description":"The page, from 1 to 20.","name":"page","in":"query"}],"responses":{"200":{"description":"One page of matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperMatchListResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getDeveloperJobsMatches"}},"/developer/jobs/search":{"get":{"description":"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.","security":[{"DeveloperKey":[]}],"summary":"Search jobs","tags":["developer"],"parameters":[{"schema":{"type":"string","minLength":2,"maxLength":200,"description":"A city or country. Omit it to search the countries in the candidate's preferences.","example":"Berlin"},"required":false,"description":"A city or country. Omit it to search the countries in the candidate's preferences.","name":"location","in":"query"},{"schema":{"type":"string","enum":["true","false"],"description":"`true` drops jobs that say they do not sponsor a visa.","example":"false"},"required":false,"description":"`true` drops jobs that say they do not sponsor a visa.","name":"needsVisaSponsorship","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":30,"description":"Only jobs posted in the last this many days.","example":7},"required":false,"description":"Only jobs posted in the last this many days.","name":"postedWithinDays","in":"query"},{"schema":{"type":"string","minLength":2,"maxLength":200,"description":"A job title. Omit it to search the titles in the candidate's preferences.","example":"Founding Engineer"},"required":false,"description":"A job title. Omit it to search the titles in the candidate's preferences.","name":"query","in":"query"},{"schema":{"type":"string","enum":["true","false"],"description":"`true` keeps only remote jobs.","example":"true"},"required":false,"description":"`true` keeps only remote jobs.","name":"remoteOnly","in":"query"},{"schema":{"type":["integer","null"],"minimum":0,"description":"Lowest yearly pay in US dollars. A job with no stated pay stays in.","example":120000},"required":false,"description":"Lowest yearly pay in US dollars. A job with no stated pay stays in.","name":"salaryMin","in":"query"}],"responses":{"200":{"description":"Jobs GetMattered can apply to now, best first.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperJobSearchResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"503":{"description":"Service Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getDeveloperJobsSearch"}},"/developer/parse":{"post":{"description":"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`.","security":[{"DeveloperKey":[]}],"summary":"Parse a resume into structured fields","tags":["developer"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperParseRequest"}}}},"responses":{"200":{"description":"The structured resume.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperParseResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"402":{"description":"The key owner's API balance has no tokens for this call. Nothing was spent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperLimitReached"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"postDeveloperParse"}},"/developer/preferences":{"get":{"description":"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.","security":[{"DeveloperKey":[]}],"summary":"Read job preferences","tags":["developer"],"responses":{"200":{"description":"The preferences.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreferencesResponse"},"example":{"data":{"benefits":null,"companySize":["startup","medium"],"createdAt":"2026-09-01T12:00:00.000Z","educationLevel":"bachelor","excludeIndustries":null,"experienceLevel":"senior","experienceLevels":["senior"],"id":311,"includeRemote":true,"industries":["Software & SaaS","Financial Services"],"isActive":true,"jobTypes":["full_time"],"locations":["San Francisco, United States"],"remoteGlobal":false,"salaryCurrency":"usd","salaryMax":190000,"salaryMin":150000,"skills":["TypeScript","React","Node.js","PostgreSQL"],"targetRoles":["Senior Software Engineer","Full Stack Developer"],"updatedAt":"2026-09-20T08:30:00.000Z","visaSponsorship":null,"workStyles":["remote","hybrid"]},"success":true}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"503":{"description":"Service Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getDeveloperPreferences"},"put":{"description":"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.","security":[{"DeveloperKey":[]}],"summary":"Save job preferences","tags":["developer"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdatePreferencesRequest"},"example":{"locations":["San Francisco, United States"],"salaryCurrency":"usd","salaryMax":190000,"salaryMin":150000,"targetRoles":["Senior Software Engineer","Full Stack Developer"],"workStyles":["remote","hybrid"]}}}},"responses":{"200":{"description":"The preferences as saved.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PreferencesResponse"},"example":{"data":{"benefits":null,"companySize":["startup","medium"],"createdAt":"2026-09-01T12:00:00.000Z","educationLevel":"bachelor","excludeIndustries":null,"experienceLevel":"senior","experienceLevels":["senior"],"id":311,"includeRemote":true,"industries":["Software & SaaS","Financial Services"],"isActive":true,"jobTypes":["full_time"],"locations":["San Francisco, United States"],"remoteGlobal":false,"salaryCurrency":"usd","salaryMax":190000,"salaryMin":150000,"skills":["TypeScript","React","Node.js","PostgreSQL"],"targetRoles":["Senior Software Engineer","Full Stack Developer"],"updatedAt":"2026-09-20T08:30:00.000Z","visaSponsorship":null,"workStyles":["remote","hybrid"]},"success":true}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"503":{"description":"Service Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"putDeveloperPreferences"}},"/developer/profile":{"get":{"description":"The candidate's name, contact, location, work authorization and links: the facts GetMattered fills application forms with. Free.","security":[{"DeveloperKey":[]}],"summary":"Read the candidate profile","tags":["developer"],"responses":{"200":{"description":"The profile.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperProfileResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"503":{"description":"Service Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getDeveloperProfile"},"patch":{"description":"Changes the fields you send and leaves the rest. Send `null` to clear a field. The same fields the candidate edits in GetMattered. Free.","security":[{"DeveloperKey":[]}],"summary":"Update the candidate profile","tags":["developer"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperProfileUpdate"}}}},"responses":{"200":{"description":"The profile after the change.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperProfileResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"503":{"description":"Service Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"patchDeveloperProfile"}},"/developer/resume":{"get":{"description":"The resume GetMattered applies with: the candidate's base resume, as text. 404 when the candidate has none yet. Free.","security":[{"DeveloperKey":[]}],"summary":"Read the resume","tags":["developer"],"responses":{"200":{"description":"The resume.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperResumeResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"503":{"description":"Service Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getDeveloperResume"},"post":{"description":"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.","security":[{"DeveloperKey":[]}],"summary":"Upload a resume","tags":["developer"],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/DeveloperResumeUploadForm"}}}},"responses":{"200":{"description":"The stored resume and the text GetMattered read from it.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperResumeUploadResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"402":{"description":"The key owner's API balance has no tokens for this call. Nothing was spent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperLimitReached"}}}},"403":{"description":"The account holds as many documents as its plan allows, and none can be removed to make room. Nothing was stored.","content":{"application/json":{"schema":{"type":"object","properties":{"code":{"type":"string"},"error":{"type":"string","enum":["limit_reached"]},"limit":{"type":"object","properties":{"action":{"type":"string"},"current":{"type":"number"},"max":{"type":"number"},"period":{"type":"string"},"planTier":{"type":["string","null"]},"reason":{"type":"string"}},"required":["action","current","max","period"]},"message":{"type":"string","minLength":1}},"required":["error","limit"]}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"postDeveloperResume"}},"/developer/tailor":{"post":{"description":"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`.","security":[{"DeveloperKey":[]}],"summary":"Tailor a resume to a job posting","tags":["developer"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperTailorRequest"}}}},"responses":{"200":{"description":"The tailored resume with its before and after ATS scores.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperTailorResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"402":{"description":"The key owner's API balance has no tokens for this call. Nothing was spent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperLimitReached"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"postDeveloperTailor"}},"/developer/usage":{"get":{"description":"Calls and the tokens they spent for each of your API keys in one calendar month (UTC). Defaults to the current month. Free.","security":[{"DeveloperKey":[]}],"summary":"Read your monthly usage","tags":["developer"],"parameters":[{"schema":{"type":"string","pattern":"^\\d{4}-(?:0[1-9]|1[0-2])$","description":"Calendar month in UTC, `YYYY-MM`.","example":"2026-11"},"required":false,"description":"Calendar month in UTC, `YYYY-MM`.","name":"month","in":"query"}],"responses":{"200":{"description":"Calls and tokens per key and operation.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperUsageResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getDeveloperUsage"}},"/developer/webhooks":{"post":{"callbacks":{"applicationEvent":{"{$request.body#/url}":{"post":{"requestBody":{"content":{"application/json":{"schema":{"def":{"type":"object","shape":{"createdAt":{"def":{"type":"string"},"type":"string"},"data":{"def":{"type":"object","shape":{"application":{"def":{"type":"nullable","innerType":{"def":{"type":"object","shape":{"company":{"def":{"type":"nullable","innerType":{"def":{"type":"string"},"type":"string"}},"type":"nullable"},"id":{"def":{"type":"number","checks":[{"def":{"type":"number","check":"number_format","abort":false,"format":"safeint"},"type":"number","isFinite":true}]},"type":"number","isFinite":true},"jobTitle":{"def":{"type":"nullable","innerType":{"def":{"type":"string"},"type":"string"}},"type":"nullable"},"landedEvidence":{"def":{"type":"array","element":{"def":{"type":"enum","entries":{"receipt":"receipt","screenshot":"screenshot"}},"type":"enum","enum":{"receipt":"receipt","screenshot":"screenshot"},"options":["receipt","screenshot"]}},"type":"array","element":{"def":{"type":"enum","entries":{"receipt":"receipt","screenshot":"screenshot"}},"type":"enum","enum":{"receipt":"receipt","screenshot":"screenshot"},"options":["receipt","screenshot"]}},"postingUrl":{"def":{"type":"nullable","innerType":{"def":{"type":"string"},"type":"string"}},"type":"nullable"},"status":{"def":{"type":"enum","entries":{"in_progress":"in_progress","held_for_review":"held_for_review","needs_you":"needs_you","landed":"landed","held":"held","not_landed":"not_landed"}},"type":"enum","enum":{"in_progress":"in_progress","held_for_review":"held_for_review","needs_you":"needs_you","landed":"landed","held":"held","not_landed":"not_landed"},"options":["in_progress","held_for_review","needs_you","landed","held","not_landed"]},"trackingUrl":{"def":{"type":"string"},"type":"string"}},"catchall":{"def":{"type":"never"},"type":"never"}},"type":"object"}},"type":"nullable"}},"catchall":{"def":{"type":"never"},"type":"never"}},"type":"object"},"id":{"def":{"type":"string"},"type":"string"},"type":{"def":{"type":"union","options":[{"def":{"type":"enum","entries":{"application.landed":"application.landed","application.not_landed":"application.not_landed","application.needs_you":"application.needs_you","application.held_for_review":"application.held_for_review"}},"type":"enum","enum":{"application.landed":"application.landed","application.not_landed":"application.not_landed","application.needs_you":"application.needs_you","application.held_for_review":"application.held_for_review"},"options":["application.landed","application.not_landed","application.needs_you","application.held_for_review"]},{"def":{"type":"literal","values":["webhook.test"]},"type":"literal","values":{}}]},"type":"union","options":[{"def":{"type":"enum","entries":{"application.landed":"application.landed","application.not_landed":"application.not_landed","application.needs_you":"application.needs_you","application.held_for_review":"application.held_for_review"}},"type":"enum","enum":{"application.landed":"application.landed","application.not_landed":"application.not_landed","application.needs_you":"application.needs_you","application.held_for_review":"application.held_for_review"},"options":["application.landed","application.not_landed","application.needs_you","application.held_for_review"]},{"def":{"type":"literal","values":["webhook.test"]},"type":"literal","values":{}}]}},"catchall":{"def":{"type":"never"},"type":"never"}},"type":"object"}}},"required":true},"responses":{"200":{"description":"Any 2xx marks the delivery delivered."}},"summary":"An application event"}}}},"description":"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=<unix seconds>,v1=<hex HMAC-SHA256 of \"<t>.<raw body>\" 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.","security":[{"DeveloperKey":[]}],"summary":"Add a webhook endpoint","tags":["developer"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperWebhookCreateRequest"}}}},"responses":{"201":{"description":"The endpoint and its signing secret, shown this once.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperWebhookCreatedResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"postDeveloperWebhooks"},"get":{"description":"Your account's webhook endpoints. The secret is never shown again; `secretPrefix` tells them apart. Free.","security":[{"DeveloperKey":[]}],"summary":"List webhook endpoints","tags":["developer"],"responses":{"200":{"description":"The endpoints, oldest first.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperWebhookListResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getDeveloperWebhooks"}},"/developer/webhooks/{id}":{"delete":{"description":"Deletes a webhook endpoint. Deliveries not yet sent to it are dropped. Free.","security":[{"DeveloperKey":[]}],"summary":"Delete a webhook endpoint","tags":["developer"],"parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"description":"The webhook endpoint id.","example":7},"required":true,"description":"The webhook endpoint id.","in":"path","name":"id"}],"responses":{"200":{"description":"The endpoint was deleted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperWebhookDeletedResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"deleteDeveloperWebhooksById"}},"/developer/webhooks/{id}/deliveries":{"get":{"description":"The newest 20 deliveries to one endpoint: event, status, attempts and the last HTTP status your endpoint answered. Free.","security":[{"DeveloperKey":[]}],"summary":"Read webhook deliveries","tags":["developer"],"parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"description":"The webhook endpoint id.","example":7},"required":true,"description":"The webhook endpoint id.","in":"path","name":"id"}],"responses":{"200":{"description":"The deliveries, newest first.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperWebhookDeliveriesResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"getDeveloperWebhooksByIdDeliveries"}},"/developer/webhooks/{id}/test":{"post":{"description":"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.","security":[{"DeveloperKey":[]}],"summary":"Send a test event","tags":["developer"],"parameters":[{"schema":{"type":"integer","exclusiveMinimum":0,"description":"The webhook endpoint id.","example":7},"required":true,"description":"The webhook endpoint id.","in":"path","name":"id"}],"responses":{"202":{"description":"The test event is queued.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeveloperWebhookTestResponse"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiErrorResponse"}}}}},"operationId":"postDeveloperWebhooksByIdTest"}}},"security":[{"DeveloperKey":[]}],"servers":[{"description":"Production","url":"https://api.getmattered.com/api/v1"}],"tags":[{"description":"The developer API: run your account end to end. Read and edit the profile, job preferences and resume, search jobs and page your matches, apply and read when the employer confirmed each application, approve or cancel held ones, and get signed webhooks when one changes. Score, parse and tailor resumes and write cover letters too. Each call sends an API key. Calls that run AI work or send an application spend tokens from your API balance, which is apart from your GetMattered plan; the rest are free.","name":"developer"}]}