Skip to main content


  • Wholesale

Place, modify and cease orders for Ethernet products 


BT Wholesale Ethernet (WE) is a national layer 2 Ethernet service*, targeting UK communication providers and It’s available across a number of bandwidth options from 0.2Mbps to 10Gbps.

As we evolve in a post-pandemic world, we are always looking for ways to make it easier for you do business with us.  This set of APIs, based on TMF standards, will give you the following functionality: order fulfilment, order tracking and request repair and diagnostics for all Ethernet products below:

  • Etherway Fibre (EAD) (LIVE)
  • Etherflow Connected (LIVE)
  • Etherflow Internet (not yet live)
  • Etherway Superfast GEA (SOGEA & FTTP) (not yet live)

For a full view of all APIs and functionality – you can view this here.

Key Features

  • Pre-qualifications/requisites prior order placement –
    • Product Qualification with respect to service availability at the specified post code
    • Pre-booking Openreach engineer’s appointments prior ordering GEA product variant (FTTP/SOGEA) requiring ONT fitment
  • Validate orders via address management and product qualification API
  • Place, modify or cease  orders for Ethernet products
  • Track orders based on open actions, order ID, milestones and other filters.


  • Deliver a truly digital order experience for you and your end customer.
  • Reduced order management costs and manual order entry errors
  • Reduced time to order/raise diagnostics & fault tickets
  • Enabling order/repair/diagnose  functionality without logging into the portal as well as full visibility into each lifecycle respectively
  • Near real time order tracking enabled for Ethernet products

How does it work

The following timelines show which functionality is supported via Ethernet APIs by which dates:

Available now:

  • Ethernet Pre-order checks including availability.
  • Ethernet Order Journeys - Place, modify, amend and cease an order for Etherway Fibre, Etherflow Connected (up to 1Gb), Etherway Superfast GEA (SOGEA & FTTP) and ETH Network (provide only).
  • Ethernet Order Tracker- includes order status updates.

Ethernet APIs launching April 2022 Onwards:

  • Pricing/Quoting for all Ethernet & DIA products- REST model written to TMF standards (legacy SOAP API model available now).
  • Ethernet Order Journeys - Place, modify, amend and cease an order for Etherflow Internet.
  • Ethernet Repair & Diagnostics.

As part of customer onboarding we will require the following to configure the API against your client ID:

Company DUNS Number (From Duns & Brad Street).

BTW portal login ID.

An end point URL to which notification messages to be triggered. 

Need more information:

New to Ethernet and want to find out more about the product in general, then click here or view or new interactive guide.  Existing customers who want to review some of our documentation should click here to access product literature from the Document Centre.

The product handbook can be found here.

APIs Included

BT Wholesale

Address Management (Ethernet)


Set an address using a UK postcode, or manually create a temporary one, before placing an order.

Product Documentation
BT Wholesale

Appointment Management (Ethernet)


Users can query for appointment slots based on particular date and book engineer appointment. This is only for standard appointments of Etherway Superfast GEA product.

Product Documentation
BT Wholesale

Product Order (Ethernet)


Place, modify and track Ethernet orders across Etherway Fibre (EAD), Etherflow Connected, Etherflow Internet and Etherway Superfast GEA (SOGEA & FTTP).

Product Documentation
BT Wholesale

Order Notification Import Orders (Ethernet)


Automated notifications on progress of orders placed via the Import Order APIs will be sent directly to the provided URL ('callback URL') provided at onboarding.

Product Documentation
BT Wholesale

Product Qualification (Ethernet)


Provides a standardized mechanism for placing a qualification request, to check offer eligibility with all of the necessary parameters.

Product Documentation