{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"company-change.schema.json","title":"Company register change: a legal entity newly registered, changed, in liquidation, bankrupt or dissolved in the last 31 days","description":"Source: official business registers with open licences: Finnish Trade Register via the PRH YTJ open data API (CC BY 4.0), the Latvian Register of Enterprises open data file on data.gov.lv (CC0 1.0), the Irish Companies Registration Office open data file (CC BY 4.0) and, where collected, the Norwegian Central Coordinating Register for Legal Entities (Brønnøysund, NLOD 2.0). Legal entities only: sole traders, sole proprietorships, individual merchants, farms, partnerships whose partners are often natural persons and other natural persons are left out. No person names (board members, owners) and no street addresses are stored; location is reduced to the municipality, county or postal district. One record per entity, event and event date.","type":"object","required":["id","register_id","country","name","legal_form","status","event","changes","event_date","register","url","verification","paid_placement","source_id","source_url","retrieved_at"],"additionalProperties":false,"properties":{"id":{"type":"string","pattern":"^[A-Z]{2}-[0-9A-Za-z-]+-(registered|changed|liquidation|reorganisation|bankrupt|dissolved)-[0-9]{4}-[0-9]{2}-[0-9]{2}$","description":"Country, register id, event and event date"},"register_id":{"type":"string","description":"The entity's number in the national register: Finnish Business ID (Y-tunnus, for example 3660361-2), Norwegian organisation number (9 digits), Latvian registration number (11 digits) or Irish CRO company number"},"country":{"type":"string","pattern":"^[A-Z]{2}$","description":"Country of the register, ISO 3166-1 alpha-2"},"name":{"type":"string","description":"Current registered name"},"previous_name":{"type":["string","null"],"description":"Name before a name change (event changed with name in changes), where the register publishes it (Finland); null otherwise"},"legal_form":{"type":"string","description":"National legal form abbreviation, for example OY, OYJ, KY, AOY (Finland), AS, ASA, NUF, SA (Norway), SIA, AS, BDR, NOD (Latvia) or LTD, DAC, CLG, PLC, ULC (Ireland); for Finnish forms without an abbreviation the PRH code, and for older Irish company types without an abbreviation the CRO company type in words"},"legal_form_name":{"type":["string","null"],"description":"Legal form in words as published by the register (English for Finland and Ireland, Norwegian for Norway, Latvian for Latvia)"},"status":{"enum":["active","in-liquidation","reorganisation","bankrupt","dissolved"],"description":"Status of the entity when retrieved (see retrieved_at)"},"event":{"enum":["registered","changed","liquidation","reorganisation","bankrupt","dissolved"],"description":"registered: entered in the register; changed: name, legal form or (Norway) main industry changed; liquidation: voluntary or compulsory liquidation started; reorganisation: corporate restructuring started (Ireland: examinership or administration); bankrupt: bankruptcy registered; dissolved: struck off, ceased or (Latvia) excluded from the register, also after a merger or division"},"changes":{"type":"array","items":{"enum":["name","legal_form","industry"]},"description":"Fields that changed, for event changed; empty otherwise"},"event_date":{"type":"string","format":"date","description":"Date of the event in the register"},"registration_date":{"type":["string","null"],"format":"date","description":"Date the entity was entered in the register"},"municipality":{"type":["string","null"],"description":"Municipality or town of the registered business address, as published; for Latvia the city or municipality (novads), for Ireland the county or Dublin postal district"},"municipality_code":{"type":["string","null"],"description":"National municipality number (Statistics Finland or Statistics Norway); null for Latvia and Ireland"},"industry_code":{"type":["string","null"],"description":"Main industry code: TOL 2008 (Finland), SN (Norway) or NACE Rev. 2 as recorded by the CRO (Ireland, digits without dots), all national versions of or equal to NACE Rev. 2; the first two digits are the NACE division. Null for Latvia (not in the open data file)"},"industry_scheme":{"enum":["TOL 2008","SN (NACE)","NACE Rev. 2",null],"description":"Classification of industry_code"},"industry_description":{"type":["string","null"],"description":"Industry in words as published"},"register":{"type":"string","description":"Register and authority"},"url":{"type":"string","format":"uri","description":"The entity's page at the register; for Latvia and Ireland, whose registers have no open entity page, the register's open data page"},"verification":{"const":"official-register","description":"Copied from the official business register's open data"},"paid_placement":{"const":false,"description":"Always false: no record is paid for or promoted"},"source_id":{"enum":["prh-ytj-open-data","brreg-enhetsregisteret","ur-lv-open-data","cro-ie-open-data"]},"source_url":{"type":"string","format":"uri"},"retrieved_at":{"type":"string","format":"date-time"}}}