Skip to content
HILLS API v1 Early access

API reference

Statuses

What a release and each of its stores can be, as the API answers. status keeps the old release word for one deprecation cycle.

Approval delivers at once; a store shows live when it is.

release_status

Code Meaning
draft Draft: Not submitted yet.
in_review In review: Submitted; waiting for a review decision.
changes_requested Changes requested: Sent back to the artist with a reason; editable again.
approved Approved: Approved: its stores are delivered right away.
archived Archived: Archived: not delivered.
taken_down Taken down: Taken down from every store it was in.

delivery_state

Code Meaning
not_started Not started: No store has been sent anything yet.
delivering Delivering: Its stores are being sent the release.
delivered Delivered — going live soon: Every store has it; none shows it live yet.
partially_live Live in some stores: Live in some stores; the others have it or are getting it.
live Live: Live in every store it went to.
needs_attention Delayed: A store failed, rejected it, or waits for a person.
taking_down Taking down: A takedown is on its way to its stores.
taken_down Taken down: Taken down from every store it was in.

update_state

Code Meaning
none Every store has the latest approved version.
pending A newer approved version waits to be sent.
delivering A newer approved version is being sent.

stores[key].status

Code Meaning
skipped Not available (phase off)
blocked On hold (phase queue)
awaiting_approval Waiting for approval (phase review)
queued Queued (phase queue)
retry_wait Sending (phase queue)
packaging Preparing (phase packing)
uploading Sending (phase sending)
manifest_sent Sending (phase sending)
requested_via_ci Delivered — going live soon (phase done)
delivered Delivered — going live soon (phase done)
acknowledged Delivered — going live soon (phase done)
live Live (phase done)
rejected_by_store Delayed (phase attention)
failed Delayed (phase attention)
cancelled Not sent (phase off)
manual_required In progress (phase attention)
takedown_queued Takedown requested (phase takedown)
takedown_sending Taking down (phase takedown)
takedown_sent Taking down (phase takedown)
taken_down Taken down (phase takedown)

status (deprecated, removed on 2027-04-30)

Code Meaning
draft release_status draft
pending release_status in_review
approved release_status approved, not live in any store yet
distributed release_status approved, live in at least one store
rejected release_status changes_requested
archived release_status archived or taken_down

Ready to integrate?

Request API access and we get back to you within 1–3 business days.