Back to home
API Platform

One API. Every partner.

Stop building bespoke integrations for every wholesale partner. Sunset wraps TalkTalk, BT Wholesale, Openreach, and more behind a single, clean REST API. You integrate once — we handle the rest.

How it works

Your systems talk to Sunset. Sunset talks to every partner.

Your Systems

CRM, BSS, OSS, portals

Single integration

Sunset API

Translation & orchestration layer

RESTJSONOAuth2Webhooks

Wholesale Partners

TalkTalk, BT, Openreach...

SOAP, REST, TMF, proprietary

The problem Sunset solves

Without Sunset

  • Build a separate integration per partner
  • Learn SOAP, TMF, and proprietary formats
  • Manage multiple auth mechanisms
  • Handle partner-specific error codes
  • 3-6 months per integration
  • Dedicated dev resource per partner

With Sunset

  • One REST API for all partners
  • Clean JSON request/response format
  • Single OAuth2 credential set
  • Normalised error codes and statuses
  • Live in days, not months
  • Zero partner-specific code to maintain

API capabilities

Everything you need to manage the full order lifecycle — from availability checks to fault management.

Address & Availability

Search addresses and check product availability across all partners through a single endpoint.

GET /api/v1/availability?postcode=LS1+4AP

Appointment Booking

Search, reserve, and confirm engineer appointments. One format, every partner.

POST /api/v1/appointments

Order Placement

Place new provide, migrate, and cease orders. Sunset translates to each partner's format.

POST /api/v1/orders

Order Tracking

Poll order status or receive webhook notifications. Normalised status codes across all partners.

GET /api/v1/orders/{orderId}/status

Order Cancellation

Cancel in-flight orders with a single call. Sunset handles each partner's cancellation flow.

DELETE /api/v1/orders/{orderId}

Trouble Tickets

Raise and track fault reports. Unified ticket format mapped to each partner's assurance API.

POST /api/v1/tickets

Why use Sunset as your middleware?

Integrate once

One API spec to learn, one set of credentials, one webhook format. Access every partner through Sunset.

Months to days

Partner API integrations typically take 3-6 months. With Sunset, you're live in days.

We handle the complexity

SOAP to REST translations, TMF mapping, authentication flows, retry logic — all handled for you.

Future-proof

When we add a new partner, you get access automatically. No code changes on your side.

Supported partners

We're continuously adding new wholesale partner integrations.

TalkTalk

Live
OrderingAvailabilityAppointmentsTrouble Tickets

PXC (TalkTalk Wholesale)

Live
Ordering (TMF622)AvailabilityAppointments (TMF646)Inventory (TMF637)

BT Wholesale

Coming soon
OrderingAvailabilityAppointments

Openreach

Coming soon
KCI NotificationsOrderingAppointments

CityFibre

Coming soon
OrderingAvailability

Vodafone

Coming soon
OrderingAvailability

Simple, clean, consistent

Every request follows the same pattern regardless of which partner fulfils the order. Standard REST conventions, JSON payloads, and consistent error handling.

  • RESTful endpoints with predictable URL structure
  • JSON request and response bodies
  • OAuth2 bearer token authentication
  • Webhook callbacks for async events
  • Idempotency keys for safe retries
  • Comprehensive error codes with descriptions
POST /api/v1/orders
// Place an order — Sunset routes to the right partner
const response = await fetch(
  "https://api.sunset.app/v1/orders",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer <token>",
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      partner: "talktalk",
      type: "provide",
      address_id: "AB12345678",
      product: "FTTP_80_20",
      appointment_id: "appt_29f3..."
    })
  }
);

Ready to integrate once and access every partner?

Get in touch to discuss your requirements, or sign in to explore the platform and API documentation.