HAAL✻CENTRAAL English translation
BRP API / Personen / Features / overzicht

search for persons by street name, house number and municipality of registration

# language: en
Feature: search for persons by street name, house number and municipality of registration
  As a consumer
  I want to find persons by supplying the street name, house number and municipality of the address at which they are registered

  Rule: persons are found where the street name, house number and municipality of the address at which they are registered match the street name (not case-sensitive), house number and municipality of registration supplied

    Scenario Outline: the straatnaam, huisnummer and municipality code of the address of persons match the straatnaam, huisnummer and municipality of registration supplied
      Given address 'A1'
        | gemeentecode (92.10) | straatnaam (11.10) | huisnummer (11.20) |
        |                 0599 | Boterdiep          |                 32 |
      And the person 'Piet'
      * 'Piet' was registered at address 'A1' 4 years ago
      When 'burgerservicenummer' is requested for persons searched by street name '<straat>', house number '32' and municipality code '0599'
      Then 'Piet' is found

      Examples:
        | straat    |
        | Boterdiep |
        | boterdiep |
        | BOTERDIEP |

    Scenario: the person to be found is registered at an address with a straatnaam one character long
      Given address 'A1'
        | gemeentecode (92.10) | straatnaam (11.10) | huisnummer (11.20) |
        |                 0692 | A                  |                 14 |
      And the person 'Piet'
      * 'Piet' was registered at address 'A1' 4 years ago
      When 'burgerservicenummer' is requested for persons searched by street name 'a', house number '14' and municipality code '0692'
      Then 'Piet' is found

    Scenario: the straatnaam supplied matches the name of the public space of an address
      Given address 'A1'
        | straatnaam (11.10)       | naam openbare ruimte (11.15) | huisnummer (11.20) |
        | Ln Copes van Cattenburch | Laan Copes van Cattenburch   |                 39 |
      And the person 'Piet'
      * 'Piet' was registered at address 'A1' 4 years ago
      When 'burgerservicenummer' is requested for persons searched by street name 'Laan Copes van Cattenburch', house number '39' and municipality code '0518'
      Then 'Piet' is found

  Rule: the optional 'huisletter' parameter (not case-sensitive) can be used to narrow the search criteria

    Scenario Outline: the straatnaam, huisnummer, huisletter and municipality code of the address of persons match the straatnaam, huisnummer, huisletter and municipality code supplied
      Given address 'A1'
        | gemeentecode (92.10) | straatnaam (11.10) | huisnummer (11.20) |
        |                 0518 | Leyweg             |                 62 |
      And address 'A2'
        | gemeentecode (92.10) | straatnaam (11.10) | huisnummer (11.20) | huisletter (11.30) |
        |                 0518 | Leyweg             |                 62 | e                  |
      And the person 'Piet'
      * 'Piet' was registered at address 'A1' 4 years ago
      And the person 'Gerda'
      * 'Gerda' was registered at address 'A2' 3 years ago
      When 'burgerservicenummer' is requested for persons searched by street name 'Leyweg', house number '62' and municipality code '0518' and parameters
        | huisletter   |
        | <huisletter> |
      Then 'Gerda' is found

      Examples:
        | huisletter |
        | e          |
        | E          |

  Rule: the optional 'huisnummertoevoeging' parameter (not case-sensitive) can be used to narrow the search criteria

    Scenario Outline: the straatnaam, huisnummer, huisnummertoevoeging and municipality code of the address of persons match the straatnaam, huisnummer, huisnummertoevoeging and municipality code supplied
      Given address 'A1'
        | gemeentecode (92.10) | straatnaam (11.10) | huisnummer (11.20) | huisletter (11.30) | huisnummertoevoeging (11.40) |
        |                 0344 | St. Jacobsstraat   |                401 | L                  | Toe                          |
      And address 'A2'
        | gemeentecode (92.10) | straatnaam (11.10) | huisnummer (11.20) | huisnummertoevoeging (11.40) |
        |                 0363 | Vitternkade        |                102 | II                           |
      And the person 'Piet'
      * 'Piet' was registered at address 'A1' 4 years ago
      And the person 'Gerda'
      * 'Gerda' was registered at address 'A2' 3 years ago
      When 'burgerservicenummer' is requested for persons searched by street name '<straat>', house number '<huisnummer>' and municipality code '<gemeente van inschrijving>' and parameters
        | huisnummertoevoeging    |
        | <huisnummer toevoeging> |
      Then '<persoon aanduiding>' is found

      Examples:
        | persoon aanduiding | gemeente van inschrijving | straat           | huisnummer | huisnummer toevoeging | opmerking                            |
        | Piet               |                      0344 | St. Jacobsstraat |        401 | Toe                   | verblijfplaats heeft ook huisletter  |
        | Piet               |                      0344 | St. Jacobsstraat |        401 | TOE                   | verblijfplaats heeft ook huisletter  |
        | Gerda              |                      0363 | Vitternkade      |        102 | II                    | verblijfplaats heeft geen huisletter |
        | Gerda              |                      0363 | Vitternkade      |        102 | ii                    | verblijfplaats heeft geen huisletter |

  Rule: wildcard matching (not case-sensitive) can be applied for the straat parameter
        For wildcard matching at least 7 letters (excluding the wildcard character) must be supplied.
        The wildcard character (*) may be supplied as the first or as the last character.

    Scenario Outline: the straatnaam or name of the public space of the address at which persons are registered matches the straatnaam supplied with wildcard matching
      Given address 'A1'
        | gemeentecode (92.10) | straatnaam (11.10)       | naam openbare ruimte (11.15) | huisnummer (11.20) |
        |                 0518 | Ln Copes van Cattenburch | Laan Copes van Cattenburch   |                 39 |
      And the person 'Piet' with citizen service number '000000025'
      * 'Piet' was registered at address 'A1' 4 years ago
      When 'burgerservicenummer' is requested for persons searched by street name '<straat>', house number '39' and municipality code '0518'
      Then 'Piet' is found

      Examples:
        | straat   |
        | ln cope* |
        | laan co* |
        | *enburch |