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

search for persons by surname, given names and municipality of registration

# language: en
Feature: search for persons by surname, given names and municipality of registration
  As a consumer
  I want to be able to find persons by supplying the municipality where they are registered together with their surname and given names

  Background:
    Given address 'A1'
      | gemeentecode (92.10) |
      |                 0599 |

  Rule: persons are found where they are registered in the municipality supplied and their surname and given names match the surname and given names supplied exactly (not case-sensitive)

    Scenario Outline: the geslachtsnaam, voornamen and municipality where persons are registered match the geslachtsnaam, voornamen and gemeenteVanInschrijving parameters supplied exactly
      Given the person 'Pieter'
      * has the following data
        | geslachtsnaam (02.40) | voornamen (02.10) |
        | Maassen               | Pieter            |
      And 'Pieter' was registered at address 'A1' 5 years ago
      When 'burgerservicenummer' is requested for persons searched by surname '<geslachtsnaam>', given names '<voornamen>' and municipality of registration '0599'
      Then 'Pieter' is found

      Examples:
        | geslachtsnaam | voornamen |
        | Maassen       | Pieter    |
        | MAASSEN       | PIETER    |
        | MAASSEN       | pieter    |

    Scenario: the person to be found has a geslachtsnaam two characters long
      Given the person 'Miriam'
      * has the following data
        | geslachtsnaam (02.40) | voornamen (02.10) |
        | Os                    | Miriam            |
      And 'Miriam' was registered at address 'A1' 5 years ago
      When 'burgerservicenummer' is requested for persons searched by surname 'Os', given names 'Miriam' and municipality of registration '0599'
      Then 'Miriam' is found

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

    Scenario: the geslachtsnaam, voorvoegsel, voornamen and municipality where the persons are registered match the geslachtsnaam, voorvoegsel, voornamen and gemeenteVanInschrijving parameters supplied
      Given the person 'Pieter'
      * has the following data
        | geslachtsnaam (02.40) | voorvoegsel (02.30) | voornamen (02.10) |
        | Maassen               | van                 | Pieter            |
      And 'Pieter' was registered at address 'A1' 5 years ago
      When 'burgerservicenummer' is requested for persons searched by surname 'Maassen', given names 'Pieter' and municipality of registration '0599' and parameters
        | voorvoegsel    |
        | <voorvoegsels> |
      Then 'Pieter' is found

      Examples:
        | voorvoegsels |
        | van          |
        | Van          |
        | VAN          |