Pricing

Corvo stores and returns money as integer cents. Draft quotes and purchased shipment details expose related but slightly different pricing views.

Purchased shipment fields

Returned by shipment detail and list

Name	Type	Required	Description
postage_cost_cents	integer	No	Raw carrier postage cost stored on the purchased shipment.
postage_markup_cents	integer	No	Corvo markup applied on top of raw postage.
envelope_fee_cents	integer	No	Per-shipment handling fee.
page_fee_cents	integer	No	Black-and-white page fee component.
page_fee_color_cents	integer	No	Color surcharge component.
tax_amount_cents	integer	No	Tax charged on the shipment, if any.
total_charged_cents	integer	No	Final amount charged for the purchased shipment in cents.

Draft quotes are different

Draft quote objects do not split raw postage and markup. Instead, they expose postage_cents as the combined quoted postage amount after markup, plus separate fee components and a combined total_cents.

Draft quote fields

Name	Type	Required	Description
postage_cents	integer	No	Quoted postage including Corvo markup.
handling_fee_cents	integer	No	Handling fee component.
printing_fee_cents	integer	No	Printing fee component.
color_surcharge_cents	integer	No	Color surcharge component.
total_cents	integer	No	Total quoted charge in cents.

Charge composition

Corvo calculates shipment totals from postage, markup, handling, printing, optional color surcharge, and tax:

total =
  postage_cost_cents
  + postage_markup_cents
  + envelope_fee_cents
  + page_fee_cents
  + page_fee_color_cents
  + tax_amount_cents

Response200Purchased shipment pricing fields

{
  "data": {
    "postage_cost_cents": 850,
    "postage_markup_cents": 128,
    "envelope_fee_cents": 300,
    "page_fee_cents": 100,
    "page_fee_color_cents": 0,
    "tax_amount_cents": 0,
    "total_charged_cents": 1378
  }
}

Response201Draft quote pricing fields

{
  "data": {
    "rates": [
      {
        "quote_id": "quote_01",
        "carrier": "USPS",
        "service": "Priority",
        "postage_cents": 978,
        "handling_fee_cents": 300,
        "printing_fee_cents": 100,
        "color_surcharge_cents": 0,
        "total_cents": 1378,
        "delivery_days": 2,
        "delivery_date": "2026-03-11T00:00:00.000Z",
        "delivery_date_guaranteed": false
      }
    ]
  }
}