Skip to main content
An order represents a request to retrieve an archival document from a repository.

​
Statuses

StatusMeaning
submittedThe order was accepted by the API.
open_for_offersResearchers can review the order and submit offers.
offers_receivedOne or more offers are available.
offer_selectedYou selected an offer.
payment_requiredPayment must be initiated or completed before fulfillment continues.
paidPayment has been accepted or authorized.
assignedThe order is assigned for fulfillment.
in_progressFulfillment work has started.
deliveredOne or more delivery documents are available.
closedThe order is complete.
withdrawnThe client withdrew the order before fulfillment work started.
expiredThe order or offer window expired.
cancelledThe order was cancelled.
unfulfillableThe order cannot be fulfilled.
refundedA payment was refunded.

​
Normal flow

submitted
open_for_offers
offers_received
offer_selected
payment_required
paid
assigned
in_progress
delivered
closed
Not every order visits every status. Fixed-price orders and account-specific workflows may skip offer or payment states.

​
Withdrawal

Use POST /orders/{orderId}/withdraw when a customer no longer wants the document. Withdrawals are only allowed before fulfillment work starts. Once the order is assigned or in progress, contact support.

​
Delivered documents

GET /orders/{orderId}/documents returns an empty array until the order reaches delivered. Document URLs are signed URLs and expire after a short period. Fetch and store the file promptly if your integration needs long-term access.