Company autocomplete

The problem

Forms where billing details are typed by hand produce typos in company IDs, stale addresses and company names in three different spellings. The error surfaces at invoicing or during a review and gets fixed manually.

It is also the most tedious part of signing up. Every extra field lowers form completion.

How FirmAPI solves it

The name search endpoint returns matches with company ID and registered address. After a selection you fetch the detail and prefill the whole form. The user types three characters instead of six fields.

Search runs across all entities including sole traders, so the autocomplete also works for customers who are not in the Commercial Register.

// 1. User types a name
const res = await fetch(
  'https://api.firmapi.sk/v1/search/name?q=' + encodeURIComponent(query),
  { headers: { 'X-API-Key': KEY } }
);
const { data } = await res.json();

// 2. Fetch the detail after selection
const detail = await fetch(
  'https://api.firmapi.sk/v1/company/ico/' + data[0].ico + '?scope=tax',
  { headers: { 'X-API-Key': KEY } }
).then(r => r.json());

form.name.value    = detail.data.name;
form.street.value  = detail.data.address.street;
form.icDph.value   = detail.data.tax.ic_dph ?? '';

Frequently asked questions