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.

Request

URI and query parameters

GET /v1/line-availability/line?districtCode=LS&NAD=A99923776374

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.

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 access product already on a stopped or working line.

The line availability checker shows more product type values than are allowed in an order when specifying "existing line product type"

The table below gives a mapping to the existing line product type attribute (SoGEA,MPF,WLR) used in SoGEA or SoADSL/SoTAP orders.

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).

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

• Address management
• Appointment management
• Product and network availability
• Order management and progress updates

Additional support

• Broadband One Product Handbook (BT Wholesale login required)
• Reference documentation
• Product catalogue
• Knowledge centre