registercheckby openlaw group
API referenceCompanies

List a company's register history

GET
/companies/{company_id}/events

Changes the register court entered for this company, newest first. Each event carries the value the entry set and, where an earlier entry of the same type exists, the value it replaced.

Costs 10 credits.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

company_id*string

The company's id.

Formatuuid

Query Parameters

type?array<>

Only events of these types.

effective_date_gte?string

Only events effective on or after this date.

Formatdate
effective_date_lte?string

Only events effective on or before this date.

Formatdate
limit?integer

Page size.

Range1 <= value <= 100
Default20
starting_after?string

Return the page after the object with this id. Cannot be combined with ending_before.

Formatuuid
ending_before?string

Return the page before the object with this id. Cannot be combined with starting_after.

Formatuuid

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/companies/497f6eca-6276-4993-bfeb-53cbbbba6f08/events"
{  "object": "list",  "has_more": true,  "url": "/v1/companies/3f1c2a9e-5b7d-4c8a-9e21-6d4f0b8a1c55/events",  "data": [    {      "id": "0d9c8b7a-6f5e-4d3c-8b2a-1f0e9d8c7b6a",      "object": "company_event",      "company_id": "3f1c2a9e-5b7d-4c8a-9e21-6d4f0b8a1c55",      "type": "company.address.changed",      "effective_date": "2026-06-02",      "register_entry_number": 3,      "previous": "Musterweg 1, 80333 München",      "current": "Beispielstraße 12, 80331 München",      "officers": []    },    {      "id": "7e6d5c4b-3a2f-4e1d-9c0b-8a7f6e5d4c3b",      "object": "company_event",      "company_id": "3f1c2a9e-5b7d-4c8a-9e21-6d4f0b8a1c55",      "type": "company.officer.appointed",      "effective_date": "2025-06-01",      "register_entry_number": 2,      "previous": null,      "current": null,      "officers": [        {          "type": "person",          "name": {            "full": "Max Mustermann",            "first": "Max",            "last": "Mustermann",            "birth_name": null,            "titles": []          },          "birth_date": null,          "city": "Augsburg",          "country": null,          "person": null,          "match_confidence": null        }      ]    }  ]}