Introduction

The StellarTools API lets you manage customers, products, checkouts, subscriptions, payments, refunds, and webhooks over plain HTTP. Every operation maps to a resource with predictable endpoints and consistent response shapes. If you’re building in TypeScript or JavaScript, the TypeScript SDK is the faster path as it wraps these endpoints with full type safety and handles auth automatically. The raw API is the right choice when you’re working in another language, integrating from a backend that can’t run Node, or need low-level control.

Base URL

https://api.stellartools.dev

Responses

Success
Error

Returns 200 with the result wrapped in a data field.

{ "data": { "id": "cus_01jx...", "object": "customer", ... } }

Every resource includes an object field identifying its type — e.g. "customer", "payment", "subscription".

Returns a non-2xx status with an error string.

{ "error": "Customer not found" }

Pagination

List endpoints support cursor-based pagination via query parameters.

number

Maximum number of records to return.

string

Return records after this resource ID (exclusive). Use the last ID in the previous page to paginate forward.

string

Return records before this resource ID (exclusive). Use the first ID in the current page to paginate backward.

List responses always have this shape:

{
  "object": "list",
  "data": [...],
  "has_more": true,
  "url": "/api/customers"
}

Versioning

Every request is pinned to an API version. Pass the version header to lock your integration to a specific behavior:

StellarTools-Version: 2026-08-18

If the header is omitted, the latest version is used. The resolved version is always echoed back in the response header. Invalid or deprecated versions return 400. Current version: 2026-08-18

Reading versioned docs

When a field is added or removed in a version, it is noted inline next to the field — not on a separate changelog page. Here is what those annotations look like:

string

The public URL for the current unpaid invoice. Only present when status is overdue. Added in 2026-08-18.

string

Full name of the customer. Deprecated in 2026-08-18 — use first_name and last_name instead.

When a request body changes, the affected fields are listed with inline notes:

string

Full name. Accepted in all versions but deprecated in 2026-08-18 — prefer the split fields below.

string

Given name. Added in 2026-08-18.

string

Family name. Added in 2026-08-18.

Rate limits

20 requests per minute per API key.

Overview

Resources

Reference Data

Base URL

Responses

Versioning

Reading versioned docs

Rate limits

​Base URL

​Responses

​Pagination

​Versioning

​Reading versioned docs

​Rate limits

Base URL

Responses

Pagination

Versioning

Reading versioned docs

Rate limits