Spain

What the Spain market sends on a deal: currency, phone format, company types, validation and the fields that carry a value.

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

At a glance

Field	Value
ISO country code	`ES`
Launch state	Open: live requests are accepted
Currency	`EUR` (€)
Phone format	E.164, country code first, no spaces required.
Example phone	`+34 612 345 678`
Regional subdivision	not collected
Company register	The Spanish commercial register
Register number asked	NIF (for example `B12345678`)
Company number format	Not asked: the register is keyed by company name, so the funnel asks for the name.
Credit score band	not collected

Company register


Register	The Spanish commercial register
`registry.source`	`official_register` in every market; which register answered is not part of the payload
Company lookup in the flow	By name: the applicant types the company name and picks the match; there is no number to ask for
Identifier	Not asked: the free path is keyed by company name, so the funnel asks the name (for example `TELEFONICA SA`)
Name search	Yes

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.

Section	Availability	Note
Identity	Available	Name, province and registry sheet
Legal form	Partial	Read from the name suffix (SL, SA)
Status	Available	Dissolution, extinction and insolvency replayed from the acts
Incorporation date	Partial	Companies formed since 2009
Registered address	Partial	Registered office as last published
Activity codes	Not exposed by the register	The objeto social as text, no structured code
Officers	Available	Appointments and dismissals as an event stream
Owners	Not exposed by the register
Accounts	Not exposed by the register
Insolvency	Available
Filings	Available

Caveats carried on every record:

Sole traders (autonomos) are not in the register.

Example registry object

Captured on 2026-09-11 for a Madrid company formed in 2026 (by name) (identifier HOSTLY SL). This is the market.registry object exactly as the API returned it.

market.registry

{
  "source": "official_register",
  "status": "partial",
  "incorporated_on": "2026-07-14",
  "company_age_months": 1,
  "company_status": "active",
  "company_type": "Sociedad de responsabilidad limitada",
  "sic_codes": null,
  "registered_office": {
    "line1": "C/ VIA DE LOS POBLADOS, 17 - PLANTA 4, NAVE 1 (MADRID)",
    "line2": null,
    "locality": null,
    "region": null,
    "postal_code": null,
    "country": "ES"
  },
  "directors": null,
  "psc_count": null,
  "accounts": null,
  "confirmation_statement": null,
  "charges_count": null,
  "has_insolvency_history": null,
  "filed_financials": null,
  "registers": null,
  "exemptions": null,
  "uk_establishments_count": null,
  "disqualified_directors_count": null,
  "registered_name": "HOSTLY SL",
  "identifiers": {
    "nif": null,
    "registry_sheet": "M 896079",
    "vat_number": null,
    "lei": null
  },
  "activity_codes": null,
  "officers": [
    {
      "name": "RAMOS RODRIGUEZ MIGUEL ANGEL",
      "role": "Adm. Mancom.",
      "appointed_on": null,
      "resigned_on": null
    }
  ],
  "filings": null,
  "share_capital": {
    "amount": 9000,
    "currency": "EUR"
  },
  "business_description": "La gestión, administración, promoción, adquisición, subcontratación, contratación proyección, y construcción, ejecución, rehabilitación, revestimiento de arrendamiento, interiores y exteriores, impermeabilizaciones, colocación y montaje de falsos techos. Reformas en general, reparación y explotació",
  "sections": {
    "vat_check": {
      "status": "unavailable",
      "data": null
    },
    "profile": {
      "status": "available",
      "data": {
        "company_name": "HOSTLY SL",
        "company_status": "active",
        "type": "Sociedad de responsabilidad limitada",
        "registry_sheet": "M 896079",
        "province": "MADRID",
        "date_of_creation": "2026-07-14",
        "registered_office_address": {
          "address_line_1": "C/ VIA DE LOS POBLADOS, 17 - PLANTA 4, NAVE 1 (MADRID)",
          "country": "ES"
        },
        "share_capital_eur": 9000,
        "business_description": "La gestión, administración, promoción, adquisición, subcontratación, contratación proyección, y construcción, ejecución, rehabilitación, revestimiento de arrendamiento, interiores y exteriores, impermeabilizaciones, colocación y montaje de falsos techos. Reformas en general, reparación y explotació",
        "officers": [
          {
            "name": "RAMOS RODRIGUEZ MIGUEL ANGEL",
            "role": "Adm. Mancom."
          }
        ],
        "last_published_act_on": "2026-09-09",
        "sic_codes": null,
        "has_insolvency_history": false,
        "vat_registered": null
      }
    }
  },
  "checked_at": "2026-09-11T14:02:30.406Z"
}

Phone and identifiers


Phone	E.164, country code first, no spaces required. For example `+34 612 345 678`.
Company identifier	Not asked: the free path is keyed by company name, so the funnel asks the name (for example `TELEFONICA SA`)
Tax identifier	NIF: A letter, seven digits and a control character, for example `A28015865`
VAT check	Not applicable: no VAT register check in this market, so `market.vat` is null.

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

Field	Type	In Spain	Notes
country	string	populated	ISO 3166-1 alpha-2, always ES in this schema. The applicant’s own country, which can differ from the routing lane.
currency	string	populated	ISO 4217 code for every figure on the deal.
monthly_revenue_band	string	populated	The band the applicant selected, kept whatever monthly_revenue_basis says.
monthly_revenue	number	populated	Monthly figure. The parsed statements’ average monthly inflow once statements are in; before that the applicant’s figure. Read monthly_revenue_basis.
monthly_revenue_basis	string	populated	statements: the parsed statements’ average monthly inflow. reported: the applicant gave the figure. band_midpoint: the midpoint of the selected band. Precedence is always statements, then register, then applicant.
time_in_business_band	string	populated	The band the applicant selected, kept whatever tib_months_basis says.
tib_months	integer	populated	Months in business. From the register’s incorporation date where the register is connected; read tib_months_basis.
tib_months_basis	string	populated	register: computed from the incorporation date on the company register. reported: from an exact trading start date the applicant gave. band_midpoint: the midpoint of the selected band. The register wins whenever it holds a date.
annual_turnover	number	null	Annual figure. The latest filed accounts where the register carries them, else what the applicant stated. Never derived from the monthly figure.
annual_turnover_basis	string	null	filed_accounts: from the latest filed accounts on the register. reported: the applicant stated the figure.
company_number	string	null	Registration number on the country’s company register. Confirmed against the register where that market answers, otherwise as the applicant gave it; registry.status says which case this deal is in, and in the United States that varies by state.
entity_type	string	populated	Legal form: the value from GET /enums/company-types for this market. From the applicant where the flow asks, else from the register; entity_type_basis says which.
entity_type_basis	string	populated	applicant: the legal form as the applicant gave it. register: read from the company register’s own record where the flow did not ask. Null when neither holds it.
vat_registered	boolean	null	Whether the business is VAT registered: from the applicant where the flow asks, else from the VAT check. Null when neither holds it.
vat	object	null	The VAT registration check against the EU VAT register.
identifiers	object	populated	The company’s identifiers in Spain: exactly these keys. A key that is present and null is not on record yet.
registry	object	populated	Public register facts for the company. Read registry.status before the facts.
director	object	null	The significant person as the flow captured them. Null until a funder’s question is answered.
credit_score_band	string	null	Self-reported band, for example "700_plus". Asked where the flow needs it; null when the applicant was not asked.
region	string	null	The state, two letters, derived from the business ZIP the applicant gave. Never inferred from anything else.
ein	string	null	Employer identification number, XX-XXXXXXX, when the applicant gave it. Optional in the flow.
signup_ip	string	null	The applicant’s IP address at the moment of consent, for funders that require it.

Company types

Value	Abbreviation	Legal form	Local name	Fundable
`sociedad_limitada`	SL	Limited liability company	Sociedad de Responsabilidad Limitada	yes
`sociedad_anonima`	SA	Public limited company	Sociedad Anonima	yes
`sociedad_cooperativa`	S. Coop.	Cooperative	Sociedad Cooperativa	yes
`sociedad_civil`	SC	Civil partnership	Sociedad Civil	accepted, not fundable
`comunidad_de_bienes`	CB	Joint ownership	Comunidad de Bienes	accepted, not fundable
`autonomo`	Autonomo	Sole trader	Empresario Individual (Autonomo)	accepted, not fundable

Spain has no connected register yet, so market.entity_type is what the applicant gave and is null on the deal until the register confirms it.

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.

funding	Label	Derived value
under_25k	Under €25K	not derived
25k_50k	€25K – €50K	not derived
50k_100k	€50K – €100K	not derived
100k_250k	€100K – €250K	not derived
250k_500k	€250K – €500K	not derived
500k_1m	€500K – €1M	not derived
1m_2m	€1M – €2M	not derived
2m_5m	€2M – €5M	not derived
5m_15m	€5M – €15M	not derived
15m_50m	€15M – €50M	not derived

monthly revenue	Label	Derived value
under_10k	Under €10K	not derived
10k_20k	€10K – €20K	not derived
20k_50k	€20K – €50K	not derived
50k_75k	€50K – €75K	not derived
75k_100k	€75K – €100K	not derived
100k_250k	€100K – €250K	not derived
250k_plus	€250K+	not derived

time in business	Label	Derived value
under_6m	Under 6 months	not derived
6_12m	6 – 12 months	not derived
1_2y	1 – 2 years	not derived
2y_plus	2+ years	not derived

credit score	Label	Derived value

Example market object

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

🇪🇸 Spain, market object

{
  "market": {
    "country": "ES",
    "currency": "EUR",
    "monthly_revenue_band": "€20K – €50K",
    "monthly_revenue": 35000,
    "monthly_revenue_basis": "band_midpoint",
    "time_in_business_band": "1 – 2 years",
    "tib_months": 1,
    "tib_months_basis": "register",
    "entity_type": "sociedad_limitada",
    "entity_type_basis": "register",
    "vat_registered": null,
    "vat": null,
    "identifiers": {
      "nif": null,
      "registry_sheet": "M 896079",
      "vat_number": null
    },
    "registry": {
      "source": "official_register",
      "status": "partial",
      "incorporated_on": "2026-07-14",
      "company_age_months": 1,
      "company_status": "active",
      "company_type": "Sociedad de responsabilidad limitada",
      "sic_codes": null,
      "registered_office": {
        "line1": "C/ VIA DE LOS POBLADOS, 17 - PLANTA 4, NAVE 1 (MADRID)",
        "line2": null,
        "locality": null,
        "region": null,
        "postal_code": null,
        "country": "ES"
      },
      "directors": null,
      "psc_count": null,
      "accounts": null,
      "confirmation_statement": null,
      "charges_count": null,
      "has_insolvency_history": null,
      "filed_financials": null,
      "registers": null,
      "exemptions": null,
      "uk_establishments_count": null,
      "disqualified_directors_count": null,
      "registered_name": "HOSTLY SL",
      "identifiers": {
        "nif": null,
        "registry_sheet": "M 896079",
        "vat_number": null,
        "lei": null
      },
      "activity_codes": null,
      "officers": [
        {
          "name": "RAMOS RODRIGUEZ MIGUEL ANGEL",
          "role": "Adm. Mancom.",
          "appointed_on": null,
          "resigned_on": null
        }
      ],
      "filings": null,
      "share_capital": {
        "amount": 9000,
        "currency": "EUR"
      },
      "business_description": "La gestión, administración, promoción, adquisición, subcontratación, contratación proyección, y construcción, ejecución, rehabilitación, revestimiento de arrendamiento, interiores y exteriores, impermeabilizaciones, colocación y montaje de falsos techos. Reformas en general, reparación y explotació",
      "sections": {
        "vat_check": {
          "status": "unavailable",
          "data": null
        },
        "profile": {
          "status": "available",
          "data": {
            "company_name": "HOSTLY SL",
            "company_status": "active",
            "type": "Sociedad de responsabilidad limitada",
            "registry_sheet": "M 896079",
            "province": "MADRID",
            "date_of_creation": "2026-07-14",
            "registered_office_address": {
              "address_line_1": "C/ VIA DE LOS POBLADOS, 17 - PLANTA 4, NAVE 1 (MADRID)",
              "country": "ES"
            },
            "share_capital_eur": 9000,
            "business_description": "La gestión, administración, promoción, adquisición, subcontratación, contratación proyección, y construcción, ejecución, rehabilitación, revestimiento de arrendamiento, interiores y exteriores, impermeabilizaciones, colocación y montaje de falsos techos. Reformas en general, reparación y explotació",
            "officers": [
              {
                "name": "RAMOS RODRIGUEZ MIGUEL ANGEL",
                "role": "Adm. Mancom."
              }
            ],
            "last_published_act_on": "2026-09-09",
            "sic_codes": null,
            "has_insolvency_history": false,
            "vat_registered": null
          }
        }
      },
      "checked_at": "2026-09-11T14:02:30.406Z"
    },
    "director": null
  }
}

Validation to expect

market.country is ES, 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 +34 612 345 678.
market.company_number does not exist in this market (the register is keyed by name), so key your records on ref.
market.region does not exist in this market: it is a US and Canada key.
The market object carries 15 keys in Spain; 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, company_number, 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.

On this page