Availability check

Required information

For every check request, at least the zip code and the corresponding house number is required. If the requested location has a house number addition, that’ll need to be supplied as well.

Some telcoes have the notion of a room. A room is actually a separate location on an address, which is not registered in the BAG information.

Example request:

{
  "requestLocation": {
    "postcode": "1234AB",
    "houseNum": 56,
    "houseNumAdd": "BIS",
    "room": "B"
  }
}

When the house number addition and/or room are not required, they either be left empty, or they can be left out completely.

Check reply

When a proper address has been entered, the availability checker will return the following information:

• The street and city of the requested location.

• All available carrier types (Copper/Fiber).

• Telco information specific to the carrier type. For example, for a KPN copper location, the available ISRA points as well as telephone numbers and service IDs on the address will be returned.

• Information about all orderable packages.

See Output examples for an overview of example responses.

Package information

As mentioned, an availability check result will also return the orderable packages. The package information contains the following information:

• The package code (required for placing orders).

• The product codes (also required for placing orders).

• The technology (Fiber or Copper).

• Product information (billing information).

• Parameters available for ordering.

For information about placing orders, see Ordering.