List your job matches
list_matchesList the job offers already matched to the caller's profile — their matches, not a search: nothing is fetched, scored or applied to here, and new offers only appear once the nightly match run has written them. Only offers with a match row for this account appear, whatever the account's role, and only offers that are still live: a posting the cleanup deactivated is never returned, however well it scored. Every row carries a numeric match score. It answers over a window — the last 30 days unless since_days says otherwise — and returns 10 offers unless limit says otherwise, at most 100, because a larger page is context the model pays for and does not read. Two counts always travel with the list: total is how many live matches fall inside the window, total_older how many fall outside it — so an empty jobs array never has to be read as "no matches": when every match is older than the window, the answer says so in summary and names the count. q filters inside that already-matched set, and narrows both counts with it. Read one offer with get_job, using a slug this returns.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Filter inside the already-matched set by title, company, description or location. It never widens the set. | |
| page | No | 1-based page of the same matched set. | |
| limit | No | Matches per page, 10 by default, at most 100. | |
| since_days | No | Width of the posting-date window in days, 30 by default. Widen it to reach the `total_older` matches. |