LIVE works today PLANNED accepted, not yet acted on TODO still to be decided
Contact: hello@arcx.cc
Start now — machine to machine, no email required
Three commands from zero to an acknowledged test delivery. The key mints instantly and is yours (per-caller account; free through the launch window).
1 · Mint your key
curl https://pennyhq.com/api/v1/b2b-ingest/free-window
Minting a key accepts the Delivery Terms (one page: non-exclusive grant, penny-a-play with 71% to the rights holder, monthly reports, net-30 payment, 2-day takedowns). Your account records the version you accepted.
Keep it — this is your account. Also valid on the Fast Pass web uploader.
2 · Send a TestMessage
curl -X POST https://pennyhq.com/api/v1/b2b-ingest/ern-batch -H "x-api-key: YOUR_KEY" -H "Content-Type: application/json" -d '{"xmlUrls":["https://pennyhq.com/delivery/samples/sample_ERN_4.3_NewReleaseMessage.xml"],"dryRun":true}'
Use our hosted sample above, or your own ERN 4.3 / 4.3.2 URLs, or a public Drive/Dropbox folder via folderUrl. MessageControlType: TestMessage is always honored — dry runs never mint.
3 · Read your acknowledgement
curl "https://pennyhq.com/api/v1/b2b-ingest/ern-batch/{batchId}/acknowledgement" -H "x-api-key: YOUR_KEY"
DDEX-style acknowledgement XML, minted the second the batch completes — your MessageIds echoed back with per-file status. JSON receipt at the same path without /acknowledgement.
Real (non-test) deliveries with masters: same key, POST …/release + finalize, or drop audio links alongside your ERNs. Humans are still here too: hello@arcx.cc. Not a machine? The human doors — artist studio, Fast Pass label uploader — live at pennyhq.com/start.
1 · Recipient
Legal entity
American Record Company LLC, dba ARCX
Receiving service
PENNY (pennyhq.com), operated by ARCX
Recipient DPID
LIVEPA-DPIDA-2026092805-4 (American Record Company LLC, issued 2026-09-28). Message form: PADPIDA20260928054.
Note
PENNY may get its own receiving DPID, separate from ARCX.
2 · Delivery
API LIVE
POST https://pennyhq.com/api/v1/b2b-ingest/release Header X-Api-Key. JSON or DDEX ERN XML, auto-detected. Metadata limit 4 MB.
Finalize LIVE
…/release/{releaseId}/finalize
Status LIVE
GET …/b2b-ingest/releases (received → minting → live, or rejected)
MCP LIVE
https://pennyhq.com/api/mcp (Streamable HTTP, no auth)
Bulk LIVE
Public Google Drive or Dropbox share links as sourceUrl, pulled server-side at finalize. Big catalogs and partner keys: hello@arcx.cc
ERN batch LIVE
POST /api/v1/b2b-ingest/ern-batch (Drive folderUrl or xmlUrls[]) · GET /api/v1/b2b-ingest/ern-batch/{batchId}
Batch drops PLANNED
SFTP / S3 folder, ERN batch profile
Flow: POST metadata → get releaseId and signed PUT URLs → PUT the cover and audio → finalize.
3 · Message profile
ERN 4.3 NewReleaseMessage
LIVE subset below
ERN 4.3.2 NewReleaseMessage
LIVE same subset. ContainsAILIVE (None → ORGANIC, Partly → HYBRID, All → AI_GEN)
LIVE recorded + prefixed on releaseRef. Allowlist PLANNED
TestMessage
LIVE validate + ack only; no release written
Updates and takedowns
PLANNED Re-post same id refreshes today
Stable release id (XML)
LIVE GRid ‖ ICPN ‖ ProprietaryId, sender-prefixed. Never bare R0
Acknowledgement out
LIVE DDEX-style Acknowledgement XML per batch — your MessageIds echoed back with per-file status, sender DPID PADPIDA20260928054. GET /api/v1/b2b-ingest/ern-batch/{batchId}/acknowledgement (your key) + auto-email when your account carries a contact address. JSON receipt unchanged.
7 · Acknowledgement time
Registration response
Immediate (synchronous)
Finalize → live
LIVE Automatic, no manual queue — typically minutes, under 1 hour at catalog scale; failures return rejected with reason.
DDEX ack SLA
LIVE — acknowledgement XML mints the second the batch completes (endpoint + auto-email). Human confirmation: one business day from hello@arcx.cc
4 · Required per release
UPC / ICPN
ReleaseId/ICPN: 12 or 13 digits, checked if present. Missing UPC accepted. House UPC (GS1 850088342) PLANNED
ISRC (every track)
ResourceId/ISRC: 12 characters, dashes stripped. Missing ISRC → sequential house ISRC (QT94L) at finalize. NEVER REJECTED
Display artist · Title
DisplayArtistName · DisplayTitleText (release and each track). REQUIRED
Label
ReleaseLabelReference → PartyList FullName (ERN 4); LabelName (ERN 3). LIVE
Release date
ReleaseDate / OriginalReleaseDate: read, not required
Territories
TerritoryCode in ReleaseDealPLANNED
Content origin
4.3.2 ContainsAILIVE: None → ORGANIC, Partly → HYBRID, All → AI_GEN. 4.3: Keywordspenny:contentOrigin=…. JSON contentOriginREQUIRED. XML omitted → ORGANIC.
File URIs
TechnicalDetails/File/URI or FileName per track, or a Drive/Dropbox sourceUrl. REQUIRED
5 · Audio and artwork
Master formats
WAV, FLAC, AIFF, MP3, M4A. Links can also be AAC, OGG or Opus.
Max file size
3 GB per file
Checks
Probed, transcoded and duration-verified before going live. Failures are marked rejected with the reason.
Sample rate / bit depth / loudness
16/24-bit, 44.1–48 kHz (up to 192 kHz accepted). No loudness normalization — your master streams as delivered. Rec: true peak ≤ −1 dBTP
pennyhq.com/delivery/terms/ — one page, v1.0. Acceptance by key use; your account is stamped with the version you accepted. Countersigned paper on request.
Earnings (FIN) LIVE
GET /api/v1/b2b-ingest/earnings (your key) — per-release and per-track streams, earned USD at the 71% rate, payable ledger. Human view: pennyhq.com/fin (paste your key). Payout method: Fast Pass → Contact & Payouts.