A single API for metadata correction, rights-chain validation, and workflow automation across the Northern Star Systems suite. Currently in private access for partners and enterprise customers.
Authentication is identical across endpoints. Payloads are normalized to a single schema. Rate limits scale with your plan. Calls are made over HTTPS to api.northernstarsystems.com.
All endpoints sit under /v1/. Breaking changes ship as /v2/ with at least 12 months overlap.
Requests and responses are JSON. CSV/DDEX inputs are accepted via the /v1/ingest endpoint and normalized server-side.
POSTs accept an Idempotency-Key header. Same key returns the same result for 24 hours.
Tokens are issued per system (HeyRoya, Kataloghub, VerseIQ, etc.) and per environment (sandbox or production). Rotate at any time from the dashboard or by emailing us.
Sandbox tokens are prefixed ns_test_, production tokens ns_live_. Sandbox writes never touch live catalog state. Token leaks should be reported to security@northernstarsystems.com.
Five endpoint families cover correction, validation, queries, reports, and webhooks. Full reference docs ship with sandbox access.
Submit a metadata payload. Receive a corrected version with a per-field diff and confidence score. High-confidence corrections apply automatically; edge cases return a review_required flag.
Check metadata against ISRC, ISWC, IPI, and client-specific rulesets without mutating it. Returns a structured list of pass/fail rules with reasoning.
Look up writers, splits, territories, and registration status by ISRC or ISWC. Joins authoritative registries with your catalog state.
Build a report from validated catalog data — leakage analysis, territory coverage, registration gaps. Sync (small) or async (large) execution.
Subscribe to correction, validation, and report events. Signed payloads (X-NSS-Signature), exponential backoff retry, 30-day event replay.
Stream large payloads (CSV, DDEX feeds, DSP exports) into the pipeline. Async by default with a job ID for polling or webhook delivery.
Standard limits below. Enterprise plans negotiate custom limits and dedicated infrastructure.
Requests per minute per token, across all endpoints. Use for development and CI.
Requests per minute per token. Standard for SaaS plans. Burst headroom available.
Dedicated infrastructure, custom limits, SLA-backed throughput. Talk to us.
In development. pip install northern-star on private index for partners.
In development. npm i @northern-star/sdk on private registry.
In development. Generated from the OpenAPI spec; module path shared with sandbox access.
Sandbox access, integration support, and a live walkthrough of the endpoint families that match your workflow. We respond within one business day.
Request API access →