API referenceJobs
List jobs
The jobs this workspace started, newest first. Each item is a full job, result
included. A value that is absent is null, never left out.
Free.
Authorization
bearerAuth AuthorizationBearer <token>
Your API key, sent as Authorization: Bearer rc_live_….
In: header
Query Parameters
subject_id?string
Only jobs for this company.
Match
^cmp_[0-7][0-9a-hjkmnp-tv-z]{25}$status?array<>
Only jobs in these statuses. Repeat the parameter for several
(status=queued&status=running).
type?array<>
Only jobs of these types. Repeat the parameter for several
(type=refresh_documents).
created_at[gte]?string
Only jobs created at or after this instant.
Match
^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]+)?Z$Format
date-timecreated_at[lte]?string
Only jobs created at or before this instant.
Match
^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}(\.[0-9]+)?Z$Format
date-timelimit?integer
Page size, 1 to 100.
Range
1 <= value <= 100Default
20cursor?string
The next_cursor of the previous page; leave it out for the first page. Opaque: pass it
back as it came. A cursor from another list, or from the same list with other filters,
answers 400 validation_failed naming cursor.
Length
1 <= length <= 2000Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://api.registercheck.de/v1/jobs" \ -H "Authorization: Bearer $REGISTERCHECK_API_KEY"{ "object": "page", "data": [ { "object": "job", "id": "job_71yahv9hep9szrn6rc3mq3yjjv", "type": "refresh_documents", "subject": { "object": "company", "id": "cmp_01hxn3rys1fh58w4d1pb1x9s81", "name": "Beispiel Reisen GmbH" }, "max_age_seconds": 3600, "refresh_documents": { "document_types": [ "current_register_extract", "chronological_register_extract", "structured_register_data" ] }, "status": "succeeded", "status_details": { "running": null, "failed": null, "canceled": null }, "status_transitions": { "running_at": "2026-11-05T10:00:09Z", "succeeded_at": "2026-11-05T10:01:41Z", "failed_at": null, "canceled_at": null }, "result": { "retrieval": "fetched", "fetched_at": "2026-11-05T10:00:41Z", "register_entries_added": 1, "expires_at": "2026-11-06T10:01:41Z", "company": { "id": "cmp_01hxn3rys1fh58w4d1pb1x9s81", "object": "company", "name": "Beispiel Reisen GmbH", "status": "active", "legal_form": "gmbh", "register": { "court": { "code": "D2601", "name": "Amtsgericht München" }, "type": "HRB", "number": "999999", "formatted": "Amtsgericht München HRB 999999", "country": "DE" }, "address": { "street": "Musterstraße 1", "postal_code": "80331", "city": "München", "state": "DE-BY", "country": "DE", "formatted": "Musterstraße 1, 80331 München", "coordinates": { "latitude": 48.1374, "longitude": 11.5755 } }, "purpose": "Planung und Durchführung von Beispielreisen", "capital": { "amount": "25000.00", "currency": "EUR" }, "representation_rule": "Ist ein Geschäftsführer bestellt, so vertritt er allein.", "identifiers": { "euid": null, "lei": null }, "industries": [], "registration_date": null, "founding_date": "2010-01-15", "termination_date": null, "last_register_entry_date": "2024-06-01", "counts": { "current_roles": 1, "documents": 1, "financial_statements": 1 } }, "documents": [ { "object": "document", "id": "doc_3cfp79y2gv9gprwftabdp7v3mz", "company_id": "cmp_01hxn3rys1fh58w4d1pb1x9s81", "type": "current_register_extract", "title": "Aktueller Abdruck", "published_date": "2026-11-05", "retrieved_at": "2026-11-05T10:00:41Z", "content_type": null, "links": { "download": "https://api.registercheck.de/v1/documents/doc_3cfp79y2gv9gprwftabdp7v3mz/content" } } ] }, "credits": { "charged": 25, "refunded": 0 }, "metadata": { "case_id": "KYB-2026-118204" }, "created_at": "2026-11-05T10:00:02Z" }, { "object": "job", "id": "job_71yahv9hep9szrn6rc3mq3yjjv", "type": "refresh_documents", "subject": { "object": "company", "id": "cmp_01hxn3rys1fh58w4d1pb1x9s81", "name": "Beispiel Reisen GmbH" }, "max_age_seconds": 3600, "refresh_documents": { "document_types": [ "current_register_extract", "chronological_register_extract", "structured_register_data" ] }, "status": "queued", "status_details": { "running": null, "failed": null, "canceled": null }, "status_transitions": { "running_at": null, "succeeded_at": null, "failed_at": null, "canceled_at": null }, "result": null, "credits": { "charged": 25, "refunded": 0 }, "metadata": { "case_id": "KYB-2026-118204" }, "created_at": "2026-11-05T10:00:02Z" } ], "next_cursor": null}