Changelog

2026-09-18

• Added a new sort-center location to rate shopping profiles: Parsel Austin.

2026-09-15

• POST /shipments accepts an optional rate_shopping_strategy (ALL, CHEAPEST, FASTEST) to override which candidate rates are considered. See Rate shopping profiles.

2026-09-11

• Rate shopping failure responses now include a machine-readable code (e.g. zip_not_serviced) alongside the existing message.
• Added a new sort-center location to rate shopping profiles: Parsel Atlanta.

2026-09-10

• Introduced scoped API tokens. A request missing a required scope now gets a 403 Forbidden with a required_scope field, enforced across the Billing, Rate shopping profiles, Shipments, and Webhooks endpoints (READ_BILLING, READ_SHIPMENTS, WRITE_SHIPMENTS, READ_WEBHOOKS, WRITE_WEBHOOKS, READ_RATE_SHOPPING_PROFILES). See Authentication and Errors.

2026-09-09

• Shipping labels gained a substatus field (e.g. ADDRESS_ISSUE, DAMAGED, LOST, WEATHER) for more detail on delivery exceptions.

2026-09-04

• GET /shipments gained brands, carriers, start_date, and end_date filters, and shipments now report a brand field.
• Shipping labels gained delivered_at and first_carrier_scan_at timestamps.

2026-08-20

• ship_date is now an accepted field on shipment/rate requests, defaulting to today. See Start shipping.

2026-08-18

• Removed the eShip-compatible API (/compatible/eship/rest/*) from the public API.

2026-08-12

• Breaking: GET /shipping_labels (list) and the tracking-events endpoints now return the standard { data, metadata } envelope instead of a bare array, and GET /shipping_labels/{id} now wraps its result in { data } instead of returning the object directly.
• Webhook events gained a url field with the delivery callback URL.

2026-08-11

• shipping_rate on a shipping label is now nullable (null for external, tracking-only labels); labels gained a shipping_rate_id, and shipping rates gained a shipment_id. custom_reference_1/custom_reference_2 are now nullable.

2026-07-31

• Added a new sort-center location to rate shopping profiles: Parsel Los Angeles - Santa Ana.

2026-07-22

• Added a new carrier service enum value: REGEA.

2026-07-17

• Added a new sort-center location to rate shopping profiles: Parsel New Jersey.

2026-07-10

• Rate shopping profiles gained zip_surcharges, per-carrier/per-ZIP DAS/EDAS designations.

2026-07-09

• GET /shipments replaced the single-value status filter with an array statuses filter (comma-separated), and gained an order_direction sort parameter.
• Added a new carrier service enum value: REGWE.

2026-07-05

• GET /shipping_labels gained a tracking_code filter.

2026-06-30

• Rate shopping profiles gained zone_tnt_mapping, a per-route zone and transit-days mapping.

2026-06-26

• Added a new webhook event type: ZIP_COVERAGE_UPDATED.

2026-06-22

• GET /shipments and GET /shipping_labels gained a status query filter.

2026-06-16

• Added Rate shopping profiles to the public API:
  • list the profiles available to your account via GET /rate_shopping_profiles,
  • fetch one (including its zip_coverage) via GET /rate_shopping_profiles/{profile_key}.
    A profile's profile_key is the value you pass as rate_shopping_profile on POST /shipments to choose which carriers Parsel rate-shops. See Rate shopping profiles for the concept.

2026-06-02

• Added a new carrier service enum value: REGSL.

2026-05-26

• Label purchase requests accept an inline_label flag; when set, the response includes label_file, the base64-encoded label. See Start shipping.
• Invoice line items gained a retail_cents field. See Billing and invoicing.

2026-05-18

• Invoices gained a deferred_cents field (unbilled postage for shipments still in transit). period_end now represents the billed-through cutoff date; period_start was removed. See Billing and invoicing.

2026-05-17

• Invoice line items gained type (POSTAGE/FEE), purchased_at, service, shipment_request_parameters, shipping_label_status, shipping_rate_metadata, and surcharges fields. See Billing and invoicing.

2026-05-05

• Added the public Billing API: read invoices and line items via GET /billing/invoices, GET /billing/invoices/{id}, and GET /billing/invoices/{id}/line_items. See Billing and invoicing for the resource model, integration walkthrough, and code samples in cURL, TypeScript, and Python; or jump to List invoices in the reference.