Read job search status
get_radar_statusState of the user's job radar: how many matches are in the working list, still waiting in the pool, saved, deferred or in the Skipped pile ('archived' counts what was skipped and what was put away); when a scan last brought something in; whether the daily automatic search is switched on; and the explicit search filters, if the user set any — the progress picture without paging through every match. last_scan_at moves when new vacancies arrive, so a scan that found nothing new leaves it unchanged. search_query is what the last scan actually searched for (role, place, country) — the role there came from the filters, career memory or the resume, so an empty filters.role does not mean the radar searched for no role; search_query.role is the title the boards were searched with and search_query.role_display the same role in the user's own words, as typed in the filters; search_role is what the next scan searches for (null: nothing names a role yet). next_scan_at is set only on the free plan while its one scan a week is spent. All zeros with auto_search_enabled=false is the normal answer for someone who has never used the radar.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| saved | No | ||
| active | Yes | Matches in the working list right now (new plus saved). | |
| filters | No | Explicit search filters, when the user set any. They outrank the resume. | |
| archived | No | ||
| deferred | No | ||
| search_role | No | The title the next scan searches for: the role from the filters, career memory or the resume, spelled the way job boards spell it once a scan has derived the search profile for this resume and role; before that, the role as set. Null means nothing names a role — a scan would fail with role_unknown until the user gives one. | |
| last_scan_at | No | ISO timestamp of the most recent match found by a scan; null if the radar never ran. | |
| next_scan_at | No | Free plan only, while its one scan a week is spent: ISO timestamp of when the next scan becomes available. Null when a scan is available now or the plan is paid (a paid plan's scans come back the next day). | |
| search_query | No | What the last scan actually searched for — the role, place and country the radar settled on from filters, career memory, the resume and, when nothing else named one, the country the user signed up from. Null before the first scan. It stays after the filters or the resume change until the next scan, so it can differ from filters and search_role, which is what the next scan will run. The role here is what the scan searched for even when filters.role is empty. | |
| pool_remaining | Yes | Found but not yet shown to the user — what a fresh look would reveal. | |
| auto_search_enabled | Yes | Whether the daily automatic scan and its digest are on for this user. | |
| search_paused_until | No | ISO timestamp the user's search pause ends, null when there is none. While paused, nothing the product starts on its own reaches them and the daily scan does not run. set_search_pause with months=null lifts it. |