The Fibre Cafe is a scalable, unified platform to support L2C provisioning, in-life modification/cease and T2R trouble resolution between communication providers (CP) and network operators or aggregators.
CPs are known as 'tenants' on the Fibre Cafe and communicate with this API - the Fibre Cafe's Tenant API. The network operators and aggregators providing the underlying services are known as 'suppliers'.
The Fibre Cafe will route requests from this API to appropriate supplier(s). Tenants will be configured to use suppliers based on requirements and commercial agreements.
Initial availability and appointing requests are synchronous. Ordering requests are asynchronous with confirmation and updates via KCIs (Keep Customer Informed).
Note: Order updates (KCIs) will be sent to the Tenant Updates API which the tenant must implement. __
© 2022-2026 Strategic Imperatives
Used to look up address identifiers and details for a given postal code or UPRN.
This is not implemented by all suppliers - it is primarily provided to assist with NAD/District Code lookup for suppliers operating on the Openreach network.
This follows the concepts in TMF673 - Address Management API.
This endpoint can be called to perform a service test on an active service.
The Fibre Cafe will validate the request and generate a service test identifier which is returned. If the test request is rejected immediately then a 4XX code will be returned with reason(s) for the rejection in the response.
The Fibre Cafe will internally determine the best supplier test to execute based on supplier and service specification attributes, in addition to the PROBLEM_TYPE characteristics supplied.
The service test result will be returned asynchronously via a KCI, and may also be queried via the GET /service-tests/{id} API.
Identifier of an existing live service
The type of problem being experienced with the service.
Details of a service the supplier provides at the selected address.
System identifier for a supplier on the Fibre Cafe that is associated with this service
curl -i -X POST \
https://prod.fibregateway.com/v1/service-tests \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'Content-Type: application/json' \
-H 'X-Conversation-ID: string' \
-H 'X-Request-ID: string' \
-d '{
"serviceId": "SI2345432345345",
"problemType": "string",
"serviceSpecification": {
"id": "ftthl2r"
},
"supplier": "DUMMY_SUPPLIER",
"characteristics": [
{
"name": "string",
"value": "string"
}
]
}'Request was received by the Fibre Cafe and will be acknowledged later via a KCI
Unique identifier to identify request and response events across the Fibre Cafe gateway
Unique reference identifying this service test (test number - generated by Fibre Cafe)
Service test lifecycle adapted from TMF653 - update events (KCIs) will be sent to the tenant as the test transitions from one state to the other.
Date/time when the service test was created
Date/time when the service test was last updated
Supplier reference for this service test (if available - for information only)
Identifier of an existing live service
The type of problem being experienced with the service.
Details of a service the supplier provides at the selected address.
System identifier for a supplier on the Fibre Cafe that is associated with this service
{ "id": 123, "status": "IN_PROGRESS", "created": "2022-01-01T09:09:33.001Z", "updated": "2022-01-01T09:45:39.001Z", "supplierReference": "A12345", "serviceId": "SI2345432345345", "problemType": "string", "serviceSpecification": { "id": "ftthl2r", "name": "FTTH" }, "supplier": "DUMMY_SUPPLIER", "characteristics": [ { … } ] }
curl -i -X GET \
'https://prod.fibregateway.com/v1/service-tests/{id}' \
-H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
-H 'X-Conversation-ID: string' \
-H 'X-Request-ID: string'Request successful - service test details were returned
Unique identifier to identify request and response events across the Fibre Cafe gateway
Unique reference identifying this service test (test number - generated by Fibre Cafe)
Service test lifecycle adapted from TMF653 - update events (KCIs) will be sent to the tenant as the test transitions from one state to the other.
Date/time when the service test was created
Date/time when the service test was last updated
Supplier reference for this service test (if available - for information only)
Identifier of an existing live service
The type of problem being experienced with the service.
Details of a service the supplier provides at the selected address.
System identifier for a supplier on the Fibre Cafe that is associated with this service
{ "id": 123, "status": "IN_PROGRESS", "created": "2022-01-01T09:09:33.001Z", "updated": "2022-01-01T09:45:39.001Z", "supplierReference": "A12345", "serviceId": "SI2345432345345", "problemType": "string", "serviceSpecification": { "id": "ftthl2r", "name": "FTTH" }, "supplier": "DUMMY_SUPPLIER", "characteristics": [ { … } ], "result": { "testValidity": "2022-01-01T09:45:39.001Z", "testMeasures": [ … ], "testOutcome": { … } } }