Skip to main content

Product And Network Availability

This API will identify available copper pairs on which to install, takeover or transfer  SOGEA or  SOADSL.

It's also used to provide the access line ID when migrating  broadband from a copper pair to full- fibre broadband (FTTP).

You'll use the Openreach NAD key and district code as query parameters in the request.

The response will show:

  • Working and Stopped lines, and products on those lines
  • How many spare copper pairs are available at the distribution point (DP) for new line provides.

To see how this API forms part of the wider Broadband One order process, click the diagram below.

Explore end to end Broadband One order process by API

Request

URI and query parameters

GET /v1/line-availability/line?districtCode=LS&NAD=A99923776374
Property Value (example) Data source Description
NAD A99923776374 Address management API (id) Openreach Gold NAD key
districtCode LS Address management API (districtId) Openreach district ID

The Response and using it to compose an order

The following describes some of the information returned from the API and how it can help in placing a broadband order. Where there is a product order attribute whose value is directly affected by an property in the API response this  is mentioned.

API Property/Object Product Order Attribute  Notes
AccessLineId ATT_X_AccessLineID

Used to identify a  working or stopped line to provide service.

Also used to identify a line on which broadband is to be migrated from to FTTP.

ProductType existingLineProductType Identifies the existing product on a working or stopped line. Directly used in SOGEA or SOADSL orders only but also informs on the possible need for a number export.
ListOfWorkingLine/ListOfStoppedLine ATT_RT_AccessLineType Shows working or stopped lines which could be used .
PendingCeaseOrderIndicator   Indicates whether a working service is currently being ceased and therefore whether a working line take over may be possible.
  ATT_X_JOURNEYTYPE Informed by the availability of stopped or working lines and any cease indicator. In the order this  attribute distinguishes between new line provide, migration/transfer, working line take over and stopped line start.
  ATT_RT_NumberExportRequired and associated attributes. When installing SoGEA or SoADSL on a WLR line and the end user wants to keep their phone number for a replacement broadband voice product.
  ATT_RT_InstallType When using an existing working or stopped line self install might be an option.

The following describes in a little more detail some of the information returned by the API and how it helps when placing an order.

ProductType

This indicates the product already on a stopped or working line.

For working lines some of the product types listed (such as ISDN) are not compatible with DSL broadband and those lines may not be used to order Broadband One.

The table below gives a mapping to the existing line product type attribute (SoGEA,MPF,WLR) used in SoGEA or SoADSL/SoTAP Broadband One orders. The values listed combine those of two different versions of the Openreach line availability API as in the future the Broadband One network availability API will change underlying versions.

WLR or MPF

Wholesale Line Rental (WLR) or MPF is required on any line hosting FTTC or ADSL (as opposed to SoGEA and SoADSL).

Where an end user already has working FTTC or ADSL the product type shown is likely to be some form of PSTN single line WLR product or sometimes MPF.

Given the stop sell rules for WLR, it is unlikely, other than in exceptional cases, that you can order new or migrate like-for-like FTTC or ADSL on a WLR line. When installing or transferring broadband on a WLR line, the WLR service will in effect be ceased, and SoADSL/SoTAP or SoGEA provided.

When converting a WLR line, and the end user wishes to keep their existing telephone number on some form of digital voice or VoIP product, the order should include details of the required associated number export order. Failing to export the number is likely to result in the loss of that number when the WLR service is ceased.

SoGEA or SoTAP

This is a data only line without PSTN/WLR. SoGEA is an Openreach VDSL "single order" access broadband product. SoTAP is the "single order transitional access product" copper pair to support the ADSL (SoADSL) broadband product. These existing products on a line are candidates for transfers/migrations or working line take overs.

Some of the product types shown in the line availability checker have no mapped value for existing line product type. This is because there is no migration path for placing orders on these lines without first ceasing the product (ISDN or multi line aux products).

Line type ProductType value Mapped value
Working PSTN Single Line WLR
Working PSTN WLR
Working PSTN Multi Line Aux  
Working ISDN2E  
Working ISDN2e System  
Working ISDN2e Standard  
Working ISDN30E  
Working ISDN30D  
Working MPF MPF
Working SMPF No mapping for this product type - Look for the corresponding WLR line.
Working SLU MPF MPF
Working SLU SMPF WLR
Working CBS SOGEA
Working SOGEA WLR SOGEA
Working SOGEA MPF SOGEA
Working SOGEA SOGEA
Working SOTAP SOADSL
Stopped PSTN WLR
Stopped ISDN WLR
Stopped MPF MPF
Stopped CBS SOGEA
Stopped SOGEA WLR SOGEA
Stopped SOGEA MPF SOGEA
Stopped SOGEA SOGEA
Stopped SOTAP SOADSL

 

PendingCeaseOrderIndicator (working lines only)

This flag indicates if the current end user is ceasing their use of that line. In the event this is because an end user is leaving the premises, the incoming new end user can ask for a "working line take over" order to be placed for a completion date which will align with the cease date of the outgoing end user. This allows the new occupant of the premises to effectively adopt an existing working broadband product on the moving day.

The benefit of a working line take over order (as opposed to a transfer/migration order) is that the lead time does not include any cooling off period and Openreach co-ordinate the stop of the pre-existing broadband  and the start of the new.

There's more information about lead times in the Broadband One handbook.

Example Response

{
    "LineAvailability": {
        "ExchangeGroupCode": "CLPM",
        "MDFSiteId": "LSCLPM",
        "ResultsTruncatedFlag": "N",
        "DesignDP": 1247,
        "DPSparePairs": 2,
        "DPType": "External",
        "StoppedLineQty": 1,
        "WorkingLineQty": 2,
        "FTTPPriorityExchange": "N",
        "WLRWithdrawal": "N",
        "MPFRestriction": "N",
        "SOTAPRestriction": "N",
        "ListOfStoppedLine": [
            {
                "ServiceId": "02086736797",
                "AccessLineId": "C000025458714",
                "LastWorkingPartialDN": 11,
                "StoppedDate": "2023-01-05",
                "ProductType": "PSTN",
                "NTEFaceplateTypeRecorded": "STANDARD",
                "NTETypeRecorded": "NTE5C",
                "NTELocationRecorded": "|RECEPTION|",
                "DateNTEDetailsRecorded": "2018-09-11",
                "InstallationType": "Standard",
                "ExchangeGroupCode": "CLPM",
                "CSSExchangeType": "DXD03",
                "MDFSiteId": "LSCLPM"
            }
        ],
        "ListOfWorkingLine": [
            {
                "AccessLineId": "C000019497559",
                "PartialDN": 70,
                "NumberRetentionAllowed": "Y",
                "ProductType": "PSTN Single Line",
                "PendingCeaseOrderIndicator": "N",
                "InstallationType": "Standard",
                "ExchangeGroupCode": "CLPM",
                "CSSExchangeType": "DXD03",
                "MDFSiteId": "LSCLPM"
            },
            {
                "AccessLineId": "UUB0089636U9",
                "NumberRetentionAllowed": "Y",
                "ProductType": "MPF",
                "PendingCeaseOrderIndicator": "N",
                "NTETypeRecorded": "NTE5C",
                "NTELocationRecorded": "|COMMS ROOM|",
                "DateNTEDetailsRecorded": "2019-06-19",
                "InstallationType": "Standard",
                "ExchangeGroupCode": "CLPM",
                "CSSExchangeType": "DXD03",
                "MDFSiteId": "LSCLPM"
            }
        ]
    },
    "MessageInfo": [
        {
            "CompletionCode": 2462,
            "Message": "FULL InstallationType data can only be requested through the B2B",
            "Severity": "Warning"
        }
    ]
}

What to do if you need a new line

If the lineAvailability.DPSparePairs value is 1 or more then there is likely to be a spare pair which Openreach can use to provide a new copper line (subject to the FTTP Priority Exchange restrictions).

If there are no spare pairs one can still place an order but there might be a delay and possibly EEC costs associated with providing additional infrastructue.

Other Broadband One tutorials

Additional support

Back to top