CurNext

SDKs

Bring CurNext into the apps you already run

Restricting the experience to our client is not enough. CurNext SDKs give your teams the freedom to extend readiness intelligence into the applications, workflows, and stacks you already operate.

What you can build

SDKs wrap the versioned REST API. Create a project API key, then call readiness, projects, devices, alerts, measurements, and webhooks from your own stack. api.curnext.app/docs

  • Pull readiness & telemetry

    Fetch surface readiness, predictions, devices, and latest measurements into dashboards or reports.

  • Automate site workflows

    Resolve alerts, list audit events, and drive ops from scripts and internal tools.

  • Integrate with your stack

    Use the same REST surface from Node, PHP, Go, Python, Java, or Flutter apps you already run.

  • Work with webhooks

    List webhook endpoints via SDK. Create and manage receivers in the dashboard for events like SURFACE_READY, ALERT_CREATED, and DEVICE_DISPLACED.

SDK

Official CurNext SDKs

Official client libraries for the CurNext REST API. Pick a language below for install steps and examples.

JavaScript

JavaScript / TypeScript

Live

Typed Fetch client for web apps, Node services, and TypeScript backends that need readiness and project context.

@curnext/sdk

View on npmAPI docs
  • Typed client
  • Node & browsers
  • Fetch API

Install

npm install @curnext/sdk

Quick start

import { CurNext } from "@curnext/sdk";

const client = new CurNext({
  apiKey: process.env.CURNEXT_API_KEY!,
  // baseUrl defaults to https://api.curnext.app
  // baseUrl: "http://localhost:4000",
});

const health = await client.health.get();
// { status: "ok", service: "curnext-api", version: "...", api: "/api/v1" }

const { projects } = await client.projects.list();
const readiness = await client.projects.getReadiness("SURFACE_EXTERNAL_ID");

console.log(readiness.status, readiness.readiness_score);

Error handling

import { CurNextApiError } from "@curnext/sdk";

try {
  const readiness = await client.projects.getReadiness("SURFACE_ID");
  console.log(readiness.status);
} catch (error) {
  if (error instanceof CurNextApiError) {
    // 401 invalid key | 404 not found | 429 rate limited
    console.error(error.statusCode, error.message, error.code, error.body);
    return;
  }
  throw error;
}

Get started

API keys live in the product

Create a project API key (cn_live_...) under Integration, then authenticate with Bearer tokens. API access is available with your site subscription.

Talk to salesOpen playground