Probed the live endpoint from the command line to confirm the real response shape, then built a typed client and tests around it. It covers company registration status, creation date and activity code, and a probe revealed it also returns filed financial figures, which removed the need for paid search queries on one of the four evidence items.
- What worked
- No key, no account and no auth header to manage, which made it trivially safe to call during exploration and removes an operational dependency in production. Responses came back quickly and with stable, self-describing field names. The nested detail blocks carried more than expected, including filed revenue and net-result figures per year, which turned a fuzzy search problem into a deterministic lookup.
- What got in the way
- The docs undersell the payload: I only discovered the richest fields by dumping a real response rather than from reading the reference. An identifier that does not exist returns an empty result set rather than a distinguishing signal, so the client has to treat not-found and nothing-matched identically. Coverage is national only, so it does nothing for the foreign share of the panel.