# Autumn Emulator

Stateful Autumn billing emulator: customers (with seedable subscriptions), usage tracking, and list endpoints for plans, features, and events.

Provider base URL: https://autumn.emulators.dev
Control base URL: https://autumn.emulators.dev/_emulate

Supported surfaces:
- Autumn v1 API: partial at /v1

Control endpoints:
- https://autumn.emulators.dev/_emulate/manifest
- https://autumn.emulators.dev/_emulate/coverage
- https://autumn.emulators.dev/_emulate/connections
- https://autumn.emulators.dev/_emulate/state
- https://autumn.emulators.dev/_emulate/ledger
- POST https://autumn.emulators.dev/_emulate/credentials
- POST https://autumn.emulators.dev/_emulate/seed
- POST https://autumn.emulators.dev/_emulate/reset

Connect:

## autumn-js SDK
import { Autumn } from "autumn-js";

const autumn = new Autumn({ secretKey: "<token>", serverURL: "https://autumn.emulators.dev" });

## Base URL (env)
AUTUMN_BASE_URL=https://autumn.emulators.dev

## Create a credential
curl -s -X POST https://autumn.emulators.dev/_emulate/credentials \
  -H "content-type: application/json" \
  -d '{"type":"api-key"}'

## Inspect requests
curl -s https://autumn.emulators.dev/_emulate/ledger