---
title: "BlendX discovery APIs"
description: "Build a Blend-ed storefront with course and program discovery, organisation branding, checkout, and enrollment APIs from blendxapi."
source: "https://docs.blend-ed.com/blendx-discovery/"
---

# BlendX discovery APIs

## What you can build
### Course discovery

List and search published courses, load course details and outlines, filter by organisation or tag, and display modes, reviews, and regional prices.

 ### Programs and organisations

Discover programs and their courses, browse organisations, and load the branding and marketing metadata required by a multi-organisation catalog.

 ### Storefront checkout

Start checkout for a guest or signed-in learner. Free items bypass the payment provider; paid items use the organisation’s configured gateway.

 ### Enrollment integrations

Let a trusted partner system grant or remove course access by email after it confirms payment outside Blend-ed. 
## Base URL
All routes in this guide are relative to the LMS:

```
https://<LMS_HOST>/blendxapi/
```
The APIs are provided by the `blendxapi` Django app, version **4.0.0** in the documented checkout. They depend on the BlendX Hasura metadata service for catalog, organisation, cart, transaction, and enrollment records.

## Storefront lifecycle
1. Load organisations, tags, courses, or programs from `/discovery/` .
2. Use the returned course or program UUID and organisation UUID in checkout.
3. Check `/discovery/user/` to choose guest or authenticated checkout.
4. Complete payment using the gateway-specific values returned by checkout.
5. Let the signed payment webhook mark the purchase and create enrollment.
6. For an external checkout, call `/enrollments/client/enroll/` only after the
external system confirms payment.

> **Keep machine credentials on the server**
> `CLIENT_API_SECRET` is instance-wide. A browser must call your storefront backend, which adds `clientapisecret` when it calls Blend-ed. Never embed the secret in client-side JavaScript, a mobile bundle, or a public repository.

## Choose a guide
[Quickstart](/blendx-discovery/quickstart/) Make a first catalog request and understand the identifiers. [API reference](/blendx-discovery/api-reference/) See every supported discovery, checkout, and client-enrollment endpoint. [Authentication](/blendx-discovery/authentication/) Use a learner identity or the server-side client credential. [Courses](/blendx-discovery/courses/) List, filter, and load course details, outlines, effort, and enrollment state. [Programs](/blendx-discovery/programs/) List programs, load program details, and discover their courses and tags. [Organisations](/blendx-discovery/organisations/) Build organisation filters and branded marketing pages. [Checkout](/blendx-discovery/checkout/) Integrate guest, authenticated, and cart-backed checkout flows. [Enrollment](/blendx-discovery/enrollment/) Grant or revoke access from a trusted external system.