GetMattered

GetMattered Job Matches API

The job-matches API from GetMattered — 15 operation(s) for job-matches.

GitHub OpenAPI

Operations 20

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /job-matches/preferences Get my job match preferences · Get Match Preferences #
Ask an LLM
“What roles, locations and salary range are my job matches based on?”
“Which preferences is the matcher currently using for me?”
Tell an agent
Show my job match preferences.
Tell me what target roles and locations my matching is set to.
PUT /job-matches/preferences Update my job match preferences · Update Match Preferences #
Ask an LLM
“How do I change the roles and locations I get matched to?”
“Can I set a minimum salary or require visa sponsorship for my matches?”
Tell an agent
Set my target roles to {targetRoles}.
Only match me to jobs paying at least {salaryMin} {salaryCurrency}.
GET /job-matches List today's job matches · List Job Matches #
Ask an LLM
“What jobs has AI matched me with today?”
“Can I see only the job matches I've saved?”
Tell an agent
List my job matches for today.
Show only my saved job matches.
GET /job-matches/work-style-supply See how many jobs my work-style choice allows · How much supply the user's work-style choice admits, and what it excludes #
Ask an LLM
“Why am I seeing so few matches with remote-only selected?”
“How many more jobs would I see if I included onsite roles?”
Tell an agent
Count how many live jobs my remote/onsite preference admits and excludes.
Show the job supply my current work-style setting leaves out.
POST /job-matches/onsite-hint/dismiss Hide the hidden-on-site-jobs hint for good #
POST /job-matches/remote-anywhere-hint/dismiss Hide the add-remote-anywhere hint for good #
GET /job-matches/{id} Get one job match · Get a Job Match #
Ask an LLM
“Can I pull up the details of a single job match?”
“What does one specific match in my feed contain?”
Tell an agent
Show job match {id}.
Get the details of my job match {id}.
POST /job-matches/{id}/save Save a job match to my listings · Save a Job Match #
Ask an LLM
“How do I save a job match so it becomes a tracked listing?”
“Can I mark a match as already applied when I save it?”
Tell an agent
Save job match {id}.
Save job match {id} with listing status {listingStatus}.
POST /job-matches/{id}/dismiss Dismiss a job match · Dismiss a Job Match #
Ask an LLM
“How do I hide a job match I'm not interested in?”
“Can I give a reason when I pass on a match?”
Tell an agent
Dismiss job match {id}.
Dismiss job match {id} because {dismissReason}.
POST /job-matches/{id}/unsave Unsave a Job Match #
POST /job-matches/{id}/restore Restore a Skipped Job Match #
POST /job-matches/subscribe-cell Get notified when a role opens in a country · Subscribe to a (role_family, country) SEO cell #
Ask an LLM
“Can I be emailed when jobs for a role family start showing up in my country?”
“What happens if there are no jobs yet for my role in a given country?”
Tell an agent
Notify me when {roleFamily} jobs appear in {country}.
Subscribe me to alerts for role family {roleFamily} in country {country}.
POST /job-matches/validate-role Check if a job title I typed is a real role · Validate a free-text role title and show its taxonomy mapping #
Ask an LLM
“Will the matcher recognize a job title I type in my own language?”
“Which role family does a custom job title map to, and is it misspelled?”
Tell an agent
Validate the job title {title} and show its role family.
Check whether {title} is a real job and suggest a spelling fix if needed.
POST /job-matches/request-more Request a fresh batch of job matches · Request More Matches (discover-empty re-fill) #
Ask an LLM
“I've gone through all my matches — can I ask for more?”
“Is there a cooldown on asking for new matches?”
Tell an agent
Find me more job matches now.
Refill my empty discover feed with new matches.
POST /job-matches/apply-relaxation Keep the widened match criteria · Apply Cascade Relaxation to Saved Preferences #
Ask an LLM
“How do I keep the broader matches that were suggested when my feed ran dry?”
“Can the widened search settings be saved to my preferences permanently?”
Tell an agent
Keep these widened matches coming by saving the relaxation to my preferences.
Apply the suggested relaxation to my saved match preferences.
POST /job-matches/revert-widening Undo widening and tighten my match feed · Undo Cascade Widening (Tighten Feed to Strict) #
Ask an LLM
“Can I undo the widened feed and go back to strictly my chosen roles and countries?”
“Will undoing the widening remove matches I already saved?”
Tell an agent destructive · confirm first
Undo the match widening and tighten my feed to strict preferences.
Remove the untouched widened matches outside my chosen roles and countries.
POST /job-matches/reset Reset all job matches to undiscovered · Reset All Matches to Discover Feed #
Ask an LLM
“Can I start my match feed over and clear everything I saved or dismissed?”
“What gets deleted when all matches are reset?”
Tell an agent destructive · confirm first
Reset all my job matches back to the discover feed.
Clear saved, dismissed and seen flags on every match and delete the linked listings.
POST /job-matches/{id}/evaluate Start a detailed evaluation of a job match · Enqueue the A-G Match Evaluation Report #
Ask an LLM
“Can I get a full report on how well I fit a job, including comp and interview plan?”
“Is it possible to regenerate a match evaluation that already exists?”
Tell an agent
Start the A-G evaluation report for job match {id}.
Regenerate the evaluation for job match {id} with force set to {force}.
GET /job-matches/{id}/evaluation Get the saved evaluation for a job match · Get Persisted A-G Match Evaluation #
Ask an LLM
“Is the evaluation report for my job match ready yet?”
“What did the A-G evaluation say about my CV fit for a job?”
Tell an agent
Show the evaluation results for job match {id}.
Get the finished A-G report blocks for match {id}.
POST /job-matches/{id}/verify-live Check a job match posting is still live · Verify a Job Match Is Still Live #
Ask an LLM
“Is the job posting behind this match still open before I apply?”
“What happens if a matched listing turns out to be dead?”
Tell an agent
Verify that job match {id} is still live.
Check if the posting for match {id} has been taken down.

Documentation

📖
APIReference
https://api.getmattered.com/api/v1/scalar

Specifications

⚙
OpenAPI
https://artifacts.apis.io/getmattered/openapi/getmattered-job-matches-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/getmattered/json-schema/getmattered-patch-user-preferences-schema.json
📊
JSONSchema
https://artifacts.apis.io/getmattered/json-schema/getmattered-upsert-application-profile-schema.json
📊
JSONSchema
https://artifacts.apis.io/getmattered/json-schema/getmattered-auto-setup-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/getmattered/json-schema/getmattered-update-preferences-request-schema.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/getmattered:getmattered-job-matches-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

getmattered-job-matches-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: support@getmattered.com
    name: GetMattered
    url: https://getmattered.com
  description: 'The GetMattered API runs the whole job hunt for you: it matches you to roles that fit your profile, rewrites your resume for each posting, writes the cover letter the form asks for, and auto-applies across the major applicant tracking systems. Every send is tracked from the swipe to the employer''s own confirmation, so you always know what landed. Authenticate with a Bearer session token. The same surface powers the web app, the mobile app and the GetMattered MCP server for ChatGPT, Claude and other agents.'
  license:
    name: Proprietary
    url: https://getmattered.com/legal/terms
  title: GetMattered Job Matches API
  version: e1c6af0f
servers:
- description: Current environment
  url: https://api.getmattered.com/api/v1
security:
- BearerAuth: []
tags:


# --- truncated at 32 KB (155 KB total) ---
# Full source: https://artifacts.apis.io/getmattered/openapi/getmattered-job-matches-api-openapi.yml