Changelog

Every change to the Partner API is listed here, newest first. Breaking changes to v1 are announced to partners before they ship. Subscribe to the Atom feed to get new entries.

v1 preview update (2026-10-13)

• GET /partner/v1/hits: each users[] row now carries the user’s identity: user_id, discord_id, discord_username and wallets. handle is unchanged.
• New GET /partner/v1/mints: one row per successful mint (task_id, user identity, wallet, chain_id, contract, tx_hash, quantity, completed_at), oldest first, paged with an opaque cursor (limit 1–500).

v1 preview (2026-10-08)

First public draft of the Partner API docs, generated from the v1 OpenAPI spec (preview: not yet live).

• GET /partner/v1/hits: successful mints on a contract booked through your app, in a window of up to 31 days (currently), with masked per-user rows and gas settings.
• GET /partner/v1/health: the calling key’s own metadata (tenant, key_id, scopes, expires_at), to test your setup and watch the expiry date.
• Server-to-server auth: private key (Authorization: Bearer nmk_live_<id>_<secret>) with a required IP allowlist, one-year expiry, scopes (read:hits) and per-key rate limits (default 60 requests a minute, burst 20).
• Errors are JSON {code, message}; authentication failures are always 401 invalid_key.
• Request signing with Ed25519 announced as coming soon.

Changes within v1 are additive only: new optional fields, new routes and new error codes. Ignore fields you do not know.