registercheckby openlaw group
API referenceJobs

Retrieve a job

GET
/jobs/{job_id}

Poll no more than once every 10 seconds. Retry-After is set while the job is queued or running. Jobs belong to the account that created them; any other job id returns 404.

Free.

Authorization

bearerAuth
AuthorizationBearer <token>

Your API key, sent as Authorization: Bearer rc_live_….

In: header

Path Parameters

job_id*string

The job's id.

Match^job_[0-7][0-9a-hjkmnp-tv-z]{25}$

Response Body

application/json

application/problem+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/job_71yahv9hep9szrn6rc3mq3yjjv" \  -H "Authorization: Bearer $REGISTERCHECK_API_KEY"

{  "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"}