HAALCENTRAAL English translation
BRP API / Personen / Features / overzicht

search for persons by surname and date of birth

# language: en
Feature: search for persons by surname and date of birth

  As a consumer
  I want to find persons by supplying their surname and date of birth

  Rule: persons are found where their date of birth and their surname match the date of birth and surname supplied (not case-sensitive)

    Scenario Outline: the geslachtsnaam and geboortedatum of persons match the geslachtsnaam and geboortedatum supplied exactly
      Given 'Pieter', born on 26-05-1983
      * has the following data
        | geslachtsnaam (02.40) | voornamen (02.10) |
        | Maassen               | Pieter            |
      And 'Jan', born on 26-05-1983
      * has the following data
        | geslachtsnaam (02.40) | voornamen (02.10) | voorvoegsel (02.30) |
        | Maassen               | Jan Peter         | van                 |
      When 'burgerservicenummer' is requested for persons searched by surname '<geslachtsnaam>' and date of birth '1983-05-26'
      Then 'Pieter en Jan' are found

      Examples:
        | geslachtsnaam |
        | Maassen       |
        | maassen       |
        | MAASSEN       |

    Scenario Outline: the person to be found has a geslachtsnaam two characters long
      Given 'Marjan', born on 26-05-1983
      * has the following data
        | geslachtsnaam (02.40) | voornamen (02.10) |
        | Os                    | Marjan            |
      When 'burgerservicenummer' is requested for persons searched by surname 'os' and date of birth '1983-05-26'
      Then 'Marjan' is found

    Scenario Outline: the geslachtsnaam of persons partly matches the geslachtsnaam supplied
      Given 'Pieter', born on 26-05-1983
      * has the following data
        | geslachtsnaam (02.40) | voornamen (02.10) |
        | Maassen               | Pieter            |
      And 'Jan', born on 26-05-1983
      * has the following data
        | geslachtsnaam (02.40) | voornamen (02.10) | voorvoegsel (02.30) |
        | Maassen               | Jan Peter         | van                 |
      And 'Petra', born on 26-05-1983
      * has the following data
        | geslachtsnaam (02.40) | voornamen (02.10) |
        | Jansen                | Petra             |
      When 'burgerservicenummer' is requested for persons searched by surname '<geslachtsnaam>' and date of birth '1983-05-26'
      Then no persons are found

      Examples:
        | geslachtsnaam |
        | Maas          |
        | jans          |
        | MAAS          |

  Rule: persons with diacritics in their surname can also be found where the variant of the surname without diacritics is supplied

    Scenario Outline: the person to be found has diacritics in their geslachtsnaam
      Given 'Albertus', born on 26-05-1983
      * has the following data
        | geslachtsnaam (02.40) | geslachtsnaam (diakrieten) |
        | Kaster                | Käster                     |
      When 'burgerservicenummer' is requested for persons searched by surname '<geslachtsnaam>' and date of birth '1983-05-26'
      Then 'Albertus' are found

      Examples:
        | geslachtsnaam |
        | Käster        |
        | Kaster        |

  Rule: the optional 'voornamen' and 'voorvoegsels' parameters (not case-sensitive) can be used to narrow the search criteria

    Scenario Outline: the geslachtsnaam, voornamen and geboortedatum of persons match the geslachtsnaam, voornamen and geboortedatum supplied exactly
      Given 'Pieter', born on 26-05-1983
      * has the following data
        | geslachtsnaam (02.40) | voornamen (02.10) |
        | Maassen               | Pieter            |
      And 'Jan', born on 26-05-1983
      * has the following data
        | geslachtsnaam (02.40) | voornamen (02.10) | voorvoegsel (02.30) |
        | Maassen               | Jan Peter         | van                 |
      When 'burgerservicenummer' is requested for persons searched by surname '<geslachtsnaam>' and date of birth '1983-05-26' and parameters
        | voornamen   |
        | <voornamen> |
      Then only '<persoon aanduiding>' is found

      Examples:
        | geslachtsnaam | voornamen | persoon aanduiding |
        | Maassen       | Pieter    | Pieter             |
        | maassen       | PIETER    | Pieter             |
        | MAASSEN       | pieter    | Pieter             |
        | maassen       | jan peter | Jan                |

    Scenario Outline: the geslachtsnaam, voorvoegsels and geboortedatum of persons match the geslachtsnaam, voorvoegsels and geboortedatum supplied exactly
      Given 'Pieter', born on 26-05-1983
      * has the following data
        | geslachtsnaam (02.40) | voornamen (02.10) |
        | Maassen               | Pieter            |
      And 'Jan', born on 26-05-1983
      * has the following data
        | geslachtsnaam (02.40) | voornamen (02.10) | voorvoegsel (02.30) |
        | Maassen               | Jan Peter         | van                 |
      When 'burgerservicenummer' is requested for persons searched by surname '<geslachtsnaam>' and date of birth '1983-05-26' and parameters
        | voorvoegsel    |
        | <voorvoegsels> |
      Then only 'Jan' is found

      Examples:
        | geslachtsnaam | voorvoegsels |
        | Maassen       | van          |
        | maassen       | VAN          |
        | MAASSEN       | Van          |

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

    Scenario Outline: the geslachtsnaam, geslacht and geboortedatum of persons match the geslachtsnaam, geslacht and geboortedatum supplied exactly
      Given the woman 'Adele', born on 26-05-1983
      * has the following data
        | geslachtsnaam (02.40) |
        | Maassen               |
      When 'burgerservicenummer' is requested for persons searched by surname 'Maassen' and date of birth '1983-05-26' and parameters
        | geslacht              |
        | <geslachtsaanduiding> |
      Then only 'Adele' is found

      Examples:
        | geslachtsaanduiding |
        | v                   |
        | V                   |

  Rule: wildcard matching (not case-sensitive) can be applied for the geslachtsnaam and voornamen parameters
        For wildcard matching at least 3 letters must be supplied, followed by the wildcard character (*)

    Scenario: the geslachtsnaam of persons matches the geslachtsnaam supplied with wildcard matching
      Given 'Groen', born on 26-05-1983
      And 'Groot', born on 26-05-1983
      And 'Groenlo', born on 26-05-1983
      When 'burgerservicenummer' is requested for persons searched by surname '<geslachtsnaam filter>' and date of birth '1983-05-26'
      Then 'Groen, Groot en Groenlo' are found

      Examples:
        | geslachtsnaam filter |
        | gro*                 |
        | Gro*                 |
        | GRO*                 |

    Scenario: the voornamen of persons match the voornamen supplied with wildcard matching
      Given 'Maassen', born on 26-05-1983
      * has the following data
        | voornamen (02.10) |
        | Jan Peter         |
      When 'burgerservicenummer' is requested for persons searched by surname 'Maassen' and date of birth '1983-05-26' and parameters
        | voornamen          |
        | <voornamen filter> |
      Then 'Maassen' is found

      Examples:
        | voornamen filter |
        | Jan*             |
        | jan*             |
        | JAN*             |