Expired jobs
The ids of jobs that left the feed. Delete them from your copy by matching the id field.
GET/v1/expired-ats
A job leaves the feed when:
- it closed: it was missing from two complete scans of the employer's board at least two hours apart. A failed, partial or suddenly much smaller scan never closes jobs, so outages at the source don't empty your copy.
- it was excluded: new evidence showed it is not in the country it was listed under, for example a location that turned out to be abroad.
An id is listed only while the job is still out of the feed; if it reappears it is active again with the same id.
Parameters
| Parameter | Type | Description |
|---|---|---|
| time_frame | string | 1h: the last hour, rolling; for hourly syncs. 1d (default): the previous UTC day, complete from 00:00 UTC; for daily syncs. 1m: the last 31 days. 6m: the last 183 days, for recovering from long outages. |
| country | list | CA, US or both (default). |
Example
bash
curl "https://api.thejobsapi.com/v1/expired-ats?time_frame=1d" -H "Authorization: Bearer $THEJOBSAPI_KEY"json
[4170012, 4170019, 4181554]Expired ids do not count toward your job allowance; each call counts as one request.