Portfolio coverage check

Drop a CSV file here, or choose a file

What the check looks at

For every line of your file the page does three things, in this order, in your browser:

1. Country: the ISO code or the country name is matched to a country. A country the API does not serve is listed as not served, and a value that is no country is reported on its line.
2. Identifier: the offline validator for that country checks the format and, where the register publishes one, the check digit: the control character of the Spanish CIF, the Luhn key of the French SIREN, the sums of the Polish NIP and REGON, the modulus 11 of the Brazilian CNPJ. A bad line names the reason, such as “Control character should be 7 or G, not 8.” The identifier validator runs the same rules one number at a time.
3. Offer: for each valid line the page looks up what Prometiam offers for that country: the company record, officers, corporate events (from a gazette or as register changes), insolvency notices (linked to the company or searched by name) and monitoring.

Then it prices the checks you tick with the published credit weights: 1 credit for a company record and 2 for officers, corporate events or insolvency; sanctions screening (beta) is 3 credits per name and needs a name column. Only the lines where the country offers a check are priced for it.

A worked example

The Load an example button fills eight lines: five well-formed companies, each from a different country, one Dutch number, one Spanish number with a wrong control character and one unknown country. With the four default checks (company record, officers, corporate events, insolvency) the page reports, computed by the page’s own code:

• 8 rows read, 6 ready to run, 1 with an identifier whose format is not valid (line 6: “Control character should be 7 or G, not 8.”) and 1 with a country that is not served (line 8).
• What the 6 ready lines can have: company record 5, officers 3 (Spain, France and the United Kingdom), corporate events 5, insolvency notices 5 and monitoring 4.
• Priced run: 5 company records at 1 credit, 3 officer lines at 2, 5 event lines at 2 and 5 insolvency lines at 2 make 31 credits, which a Starter plan of 1,000 credits a month covers many times over.
• By country: Spain, France and the United Kingdom offer the record, officers, events and linked insolvency notices. Romania offers the record, register-change events and monitoring, but no officers and no insolvency notices. The United States offers the record, register-change events and monitoring, with insolvency notices searched by name. The Netherlands offers insolvency notices by name only.

Reading the result correctly

• Ready to run means a well-formed identifier in a country Prometiam serves. It does not mean the company is in the data: sole traders and the legal forms a register does not serve are never returned, so a valid number can still find nothing. Only a run, or an evaluation key on your real book, gives a hit rate.
• Insolvency notices cover sixteen markets and corporate insolvency only. Where they are searched by name (the United States and Germany, for example) they are not linked to the company record, so matches need review.
• Officers are served for Spain, France, the United Kingdom, Norway and Poland only (Polish natural persons are masked by the register). Every other country is company records only.
• Monitoring covers every live country except France and Chile. It is limited by the number of monitored companies a plan allows, not priced per run: 25 on Starter, 250 on Professional, 2,500 on Scale.
• The credit total estimates one pass over the file. Errors are free.

From the check to a real run

1. Fix the lines the report flags. A format error is cheapest to correct before any call.
2. Take the priced total to a plan: Starter includes 1,000 credits a month, Professional 10,000 credits and Scale 50,000 credits. The page names the smallest plan that covers your total.
3. Run the list with the batch lookup, POST /companies/lookup: up to 100 companies per call, every item counted as one request. An over-quota batch is refused up front with 429 batch_exceeds_quota and max_items_now, so a batch is never started that your credits cannot finish.
4. Add the insolvency check (POST /insolvency/check, up to 100 counterparties per call) and monitoring for the companies you want to follow.
5. If you are an institution and need the real hit rate before a contract, request an evaluation key below.

More on running lists: batch screening and bulk lookup, the company lookup API and the KYB API.

Questions