Netherlands

The Netherlands lane routes deals in EUR with market.country set to NL. Everything below is what your integration can rely on for this market.

At a glance

Company register

What comes back, section by section

Read registry.status first. available means every section the register exposes came back; partial means at least one could not be read; unavailable means the company profile itself could not be retrieved; not_fetched means no lookup has run for this lead yet. A section the register does not expose is null on every deal, never an empty value. Each entry under registry.sections carries the register's status for that section and the facts it returned, nothing else.

Example registry object

The register connection for this market is not live yet, so this is the shape you receive today: every fact null and status set to not_fetched. The keys do not change when it goes live.

{
  "source": "official_register",
  "status": "not_fetched",
  "reason": "not_yet_available"
}

Phone and identifiers

Bank statements

The flow asks for the last 6 months of business bank statements in this market. Statements are uploaded once and shared with every partner working the request; the API carries the parsed facts (months covered, average monthly inflow and outflow, provider) and the documents by signed link.

Instant matching

Requests are accepted, validated and register-checked, then worked by a person until a funding panel is connected for this market. The payload shape is identical; only the timing of matched options differs.

Which market fields are populated

Company types

Amount and revenue bands

A band stays a band. Where we derive a number from a band, the payload says so in the matching _basis field, so never treat a derived figure as reported.

Example market object

This is the market object exactly as GET /deals/{ref} returns it for this country.

{
  "market": {
    "country": "NL",
    "currency": "EUR",
    "monthly_revenue_band": "€50K – €75K",
    "monthly_revenue": 62500,
    "monthly_revenue_basis": "band_midpoint",
    "time_in_business_band": "2+ years",
    "tib_months": 30,
    "tib_months_basis": "band_midpoint",
    "company_number": null,
    "entity_type": null,
    "entity_type_basis": null,
    "vat_registered": null,
    "vat": null,
    "identifiers": {
      "vat_number": null
    },
    "registry": {
      "source": "official_register",
      "status": "not_fetched",
      "reason": "not_yet_available"
    },
    "director": {
      "full_name": "Sanne Voorbeeld",
      "date_of_birth": "1979-11-02",
      "residential_address": {
        "line1": "Keizersgracht 1",
        "postal_code": "1015 AA"
      },
      "nationality": "NL"
    }
  }
}

Validation to expect

• market.country is NL, never the routing lane and never an alpha-3 code.
• Every monetary figure on the deal is in EUR.
• Phone numbers arrive in E.164, for example +31 6 12345678.
• market.company_number carries the register number and market.registry carries the register facts.
• market.region does not exist in this market: it is a US and Canada key.
• The market object carries 16 keys in Netherlands; a key that is present and null is not known yet, a key that is absent is not part of this market. Keys this market does not carry: annual_turnover, annual_turnover_basis, credit_score_band, region, ein, signup_ip.

Reference

The full field list, types and response schema live on Retrieve a deal, where the country switcher shows this market's example inline.