ACC API

A provenance object partner systems can read.

ACC API is the product surface for distributors, DSPs, labels, catalog owners and licensing teams that need certificate category, status, hashes, declaration version and verification URL inside their own workflows.

Current endpoints

GET /api/v1/certificatesPOST /api/v1/certificatesGET /api/v1/certificates/{certificateId}POST /api/v1/verifyGET /api/v1/works/{isrc}GET /api/v1/search?q={query}GET /api/v1/anchorsGET /api/v1/ledger/events

Partner controls

Pilot authentication is designed around bearer partner keys. Public review endpoints remain open for validation; partner access requests can already identify the calling partner and appear in audit logs.

Request API pilot

Partner auth

Public review endpoints work without auth for partner validation.

Partner access requests can send Authorization: Bearer acc_partner_review.

Production pilots receive partner-specific bearer keys, audit partnerId and agreed rate limits.

ACC_REQUIRE_PARTNER_AUTH=true can gate the API without changing client paths.

Authorization: Bearer acc_partner_review

Pilot limits

Public review endpoints are protected by lightweight rate limits. Partner pilots will receive explicit limits, partner IDs and audit exports before any production integration.

Recommended pilot start: one workflow, one catalog subset, one integration owner and one expected decision that ACC status should improve.

Certified response

{
  "valid": true,
  "status": "anchored",
  "matchedCertificateId": "ACC-2026-023F0159",
  "certificate": {
    "category": "HUMAN",
    "identityAssuranceLevel": "LEVEL_2_SIGNED_DECLARATION",
    "work": {
      "declaredProducerName": "Mira Nowak",
      "isrc": "PL2O52600001",
      "isrcDisplay": "PL-2O5-26-00001",
      "isrcSource": "acc_assigned",
      "isrcAssignedBy": {
        "name": "Art Clearance Certification Sp. z o.o."
      }
    },
    "anchorBatch": { "status": "anchored" }
  },
  "auth": {
    "partnerId": "public-partner-review",
    "mode": "partner_key",
    "authenticated": true
  }
}

Not certified response

{
  "isrc": "USRC17607839",
  "accStatus": "not_certified",
  "certificates": [],
  "externalLookup": {
    "source": "MusicBrainz",
    "found": true
  }
}

ACC_AUTH_INVALID

HTTP 401. Invalid partner API key when auth is required.

ACC_VALIDATION_ERROR

HTTP 400. Required certificate, hash or declaration field is missing or malformed.

ACC_NOT_FOUND

HTTP 404. Certificate or anchor batch does not exist.

ACC_RATE_LIMIT

HTTP 429. Request volume exceeded the controlled-access safety limit.

ACC_CORE_UNAVAILABLE

HTTP 503. ACC Core could not answer and no local fallback was available.

Integration path

Bring one partner workflow. ACC will return the proof object.

A pilot can start with a small ISRC list, upload workflow, catalog subset or licensing scenario. The output is a certificate status object, public proof URL and ledger/anchor state that your system can read.

Request partner API pilot

certificateId

ACC API response field.

status

ACC API response field.

work.title

ACC API response field.

work.artistName

ACC API response field.

work.declaredProducerName

ACC API response field.

work.isrc

ACC API response field.

work.isrcSource

ACC API response field.

work.isrcAssignedBy

ACC API response field.

audioHash

ACC API response field.

declarationHash

ACC API response field.

anchorBatch.status

ACC API response field.

verificationUrl

ACC API response field.