> ## Documentation Index
> Fetch the complete documentation index at: https://docs.automindz.co/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Arbeitsagentur job scrape status
> Poll the status and results of an Arbeitsagentur job search
Poll until `status` is `COMPLETED` or `FAILED`. The `result` field is populated on completion.
**Polling guidance:** Check every 15–30 seconds. Listing-only searches finish quickly; enabling `solve_captcha` adds a few seconds per contact-enriched job.
## Example responses
```json theme={null}
{
"request_id": "run_ba_abc123",
"status": "RUNNING",
"result": null,
"started_at": "2026-06-29T07:30:00.000Z",
"finished_at": null
}
```
```json theme={null}
{
"request_id": "run_ba_abc123",
"status": "COMPLETED",
"result": {
"company": "Bundesagentur für Arbeit",
"url": "https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1&wo=Berlin&umkreis=25",
"search_urls": [
"https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1&wo=Berlin&umkreis=25"
],
"total_found": 1240,
"jobs_returned": 25,
"pages_scraped": 1,
"jobs": [
{
"job_title": "Maler (m/w/d)",
"location": "10115 Berlin, BERLIN",
"city": "Berlin",
"country": "Germany",
"job_description": "Wir suchen Maler/Lackierer ...",
"hiring_manager_name": "Olaf Jöken",
"hiring_manager_email": "bewerbung.berlin@stewe.de",
"hiring_manager_phone": "+49 170 1571335",
"company_name": "Schowin & Geuge",
"job_url": "https://www.arbeitsagentur.de/jobsuche/jobdetail/10001-1003290276-S",
"posted_at": "2026-06-26"
}
]
},
"started_at": "2026-06-29T07:30:00.000Z",
"finished_at": "2026-06-29T07:33:00.000Z"
}
```
```json theme={null}
{
"request_id": "run_ba_jkl012",
"status": "FAILED",
"result": null,
"started_at": "2026-06-29T07:30:00.000Z",
"finished_at": "2026-06-29T07:30:09.000Z"
}
```
## OpenAPI
````yaml openapi.json GET /v1/scrape-arbeitsagentur-jobs/async/{request_id}
openapi: 3.1.0
info:
title: Automindz API
version: 0.1.0
servers:
- url: https://api.automindz.co
description: Production
security: []
paths:
/v1/scrape-arbeitsagentur-jobs/async/{request_id}:
get:
tags:
- scrape-arbeitsagentur-jobs
summary: Get Scrape Arbeitsagentur Jobs Status
operationId: >-
get_scrape_arbeitsagentur_jobs_status_v1_scrape_arbeitsagentur_jobs_async__request_id__get
parameters:
- name: request_id
in: path
required: true
schema:
type: string
description: The `run_...` id returned by the scrape endpoint.
title: Request Id
description: The `run_...` id returned by the scrape endpoint.
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/ArbeitsagenturJobsStatusResponse'
example:
request_id: run_ba_abc123
status: COMPLETED
result:
company: Bundesagentur für Arbeit
url: >-
https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1&wo=Berlin&umkreis=25
search_urls:
- >-
https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1&wo=Berlin&umkreis=25
total_found: 1240
jobs_returned: 25
pages_scraped: 1
jobs:
- job_title: Maler (m/w/d)
location: 10115 Berlin, BERLIN
city: Berlin
country: Germany
job_description: Wir suchen Maler/Lackierer ...
hiring_manager_name: Olaf Jöken
hiring_manager_email: bewerbung.berlin@stewe.de
hiring_manager_phone: +49 170 1571335
job_url: >-
https://www.arbeitsagentur.de/jobsuche/jobdetail/10001-1003290276-S
company_name: Schowin & Geuge
posted_at: '2026-06-26'
started_at: '2026-06-29T07:30:00.000Z'
finished_at: '2026-06-29T07:33:00.000Z'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
security:
- HTTPBearer: []
components:
schemas:
ArbeitsagenturJobsStatusResponse:
properties:
request_id:
type: string
title: Request Id
status:
type: string
title: Status
description: 'Run lifecycle: `QUEUED`, `RUNNING`, `COMPLETED`, or `FAILED`.'
result:
anyOf:
- $ref: '#/components/schemas/ArbeitsagenturResult'
- type: 'null'
description: Populated only when `status` is `COMPLETED`; null otherwise.
started_at:
anyOf:
- type: string
- type: 'null'
title: Started At
finished_at:
anyOf:
- type: string
- type: 'null'
title: Finished At
type: object
required:
- request_id
- status
title: ArbeitsagenturJobsStatusResponse
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ArbeitsagenturResult:
properties:
company:
anyOf:
- type: string
- type: 'null'
title: Company
url:
anyOf:
- type: string
- type: 'null'
title: Url
search_urls:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Search Urls
total_found:
anyOf:
- type: integer
- type: 'null'
title: Total Found
jobs_returned:
anyOf:
- type: integer
- type: 'null'
title: Jobs Returned
pages_scraped:
anyOf:
- type: integer
- type: 'null'
title: Pages Scraped
jobs:
anyOf:
- items:
$ref: '#/components/schemas/JobPosting'
type: array
- type: 'null'
title: Jobs
warnings:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Warnings
additionalProperties: true
type: object
title: ArbeitsagenturResult
description: >-
BA job-board scrape result shape (distinct from the career-page
scraper).
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
type: object
required:
- loc
- msg
- type
title: ValidationError
JobPosting:
properties:
job_title:
anyOf:
- type: string
- type: 'null'
title: Job Title
location:
anyOf:
- type: string
- type: 'null'
title: Location
city:
anyOf:
- type: string
- type: 'null'
title: City
country:
anyOf:
- type: string
- type: 'null'
title: Country
job_type:
anyOf:
- type: string
- type: 'null'
title: Job Type
remote_policy:
anyOf:
- type: string
- type: 'null'
title: Remote Policy
department:
anyOf:
- type: string
- type: 'null'
title: Department
salary_min:
anyOf:
- type: number
- type: 'null'
title: Salary Min
salary_max:
anyOf:
- type: number
- type: 'null'
title: Salary Max
salary_currency:
anyOf:
- type: string
- type: 'null'
title: Salary Currency
salary_period:
anyOf:
- type: string
- type: 'null'
title: Salary Period
min_years_of_experience:
anyOf:
- type: integer
- type: 'null'
title: Min Years Of Experience
requirements:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Requirements
nice_to_have:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Nice To Have
benefits:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Benefits
job_description:
anyOf:
- type: string
- type: 'null'
title: Job Description
hiring_manager_name:
anyOf:
- type: string
- type: 'null'
title: Hiring Manager Name
hiring_manager_email:
anyOf:
- type: string
- type: 'null'
title: Hiring Manager Email
hiring_manager_phone:
anyOf:
- type: string
- type: 'null'
title: Hiring Manager Phone
job_url:
anyOf:
- type: string
- type: 'null'
title: Job Url
ats_system:
anyOf:
- type: string
- type: 'null'
title: Ats System
posted_at:
anyOf:
- type: string
- type: 'null'
title: Posted At
application_deadline:
anyOf:
- type: string
- type: 'null'
title: Application Deadline
company_name:
anyOf:
- type: string
- type: 'null'
title: Company Name
additionalProperties: true
type: object
title: JobPosting
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
````