Skip to content

Split Street

Split a combined street string (e.g. "Lindenstraße 28") into separate streetName and houseNumber fields.

Method: splitStreet

API KeyNot set

Stored in localStorage — never sent to this site.

Parameters
ISO 3166-1 Alpha-2, improves accuracy
Request Preview
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "splitStreet",
  "params": {}
}
Set an API key above to enable live requests.

Parameters

FieldRequiredTypeDescription
streetFullYesStringCombined street + house number (e.g. Lindenstraße 28)
countryNoStringISO 3166-1 Alpha-2 country code. Improves accuracy for country-specific formats.

Response

json
{
  "result": {
    "streetName": "Lindenstraße",
    "houseNumber": "28",
    "additionalInfo": ""
  }
}
FieldTypeDescription
streetNameStringStreet name without number
houseNumberStringHouse number (may include suffixes like 28a)
additionalInfoStringAny remaining text after the house number (e.g. apartment)

Examples

Standard German address

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "splitStreet",
  "params": {
    "streetFull": "Lindenstraße 28"
  }
}

Response:

json
{
  "result": {
    "streetName": "Lindenstraße",
    "houseNumber": "28",
    "additionalInfo": ""
  }
}

Address with house number suffix

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "splitStreet",
  "params": {
    "streetFull": "Balthasar-Neumann Str. 4b",
    "country": "DE"
  }
}

Response:

json
{
  "result": {
    "streetName": "Balthasar-Neumann Str.",
    "houseNumber": "4b",
    "additionalInfo": ""
  }
}

When to Use

Use splitStreet when your data source provides a combined address field and you need to pass street + houseNumber separately to addressCheck or store them in separate database columns.

Typical workflow:

1. Receive input: streetFull = "Hauptstr. 22a"
2. Call splitStreet → streetName = "Hauptstr.", houseNumber = "22a"
3. Call addressCheck with the split fields for full validation

Endereco JSON-RPC API