parcelLab

parcelLab is a Munich-headquartered post-purchase experience platform (parcelLab GmbH) used by retailers including IKEA, Hugo Boss, Dyson, Puma, and John Lewis to turn delivery and returns into a branded, revenue-generating part of the customer journey. The platform spans four modules — Convert (pre-checkout delivery promise), Engage (multichannel post-purchase communications), Retain (Returns Portal and returns experience), and Insights (analytics, benchmarking, control tower) — layered with AI agents (WISMO/R, Insights, Fraud & Abuse) and exposed via the parcelLab API v4 Enhanced. Global, EU, and US regional endpoints are available; the same data backs a Model Context Protocol server at agents.parcellab.com/mcp/ for agentic clients.

2 APIs 10 Features

Post-PurchaseE-CommerceTrackingReturnsShippingDeliveryCustomer ExperienceLogisticsCommunicationsGermany

APIs

parcelLab API

parcelLab API v4 Enhanced — the unified REST API for ingesting orders and trackings, retrieving order status, looking up pickup/drop-off locations, predicting delivery dates (Pr...

parcelLab MCP Server

Hosted Model Context Protocol server exposing the parcelLab order tracking and returns registration workflow to MCP-compatible agents, authenticated via OAuth 2.1 bearer tokens ...

Collections

parcelLab API

POSTMAN

parcelLab API

OPEN

Arazzo Workflows

parcelLab Create and Fetch Return

Create a return registration and immediately read it back by external id.

ARAZZO

parcelLab Evaluate Campaign and Log Redirect

Evaluate campaign targeting for a tracking, then record a redirect analytics event.

ARAZZO

parcelLab List and Get Return

List return registrations for an account, then fetch the first one in detail.

ARAZZO

parcelLab Predict Delivery and Create Order

Get a pre-checkout delivery prediction, then create the order it describes.

ARAZZO

parcelLab PUDO Lookup and Register Return

Find a nearby drop-off point, then open a return registration for the order.

ARAZZO

parcelLab Register Return and Collect Survey

Create a return registration, then submit a survey response tied to it.

ARAZZO

parcelLab Resolve Config and Register Return

Resolve a return configuration for an account, then register a return with it.

ARAZZO

parcelLab Send Event and Refresh Status

Push a warehouse or shop event into the timeline, then refresh the order status.

ARAZZO

parcelLab Survey Fetch and Submit

Load a survey, fetch its prefilled answers for a reference, then submit a response.

ARAZZO

parcelLab Track and Target Campaign

Read an order's tracking status, then evaluate a campaign for that tracking.

ARAZZO

parcelLab Create Order and Track

Create or update an order, then retrieve its latest tracking and checkpoints.

ARAZZO

Pricing Plans

Parcellab Plans Pricing

4 plans

PLANS

Rate Limits

Parcellab Rate Limits

2 limits

RATE LIMITS

FinOps

Parcellab Finops

FINOPS

Features

Delivery Promise

Pre-checkout delivery date prediction (Promise API) to drive cart conversion.

Order & Tracking Ingestion

Idempotent v4 Orders API with mutations to add/cancel trackings or amend line items.

Carrier Network

Integrations with 450+ carriers worldwide via direct carrier interfaces.

Returns Portal

Branded self-service returns portal with refund options, exchanges, retention offers, split returns, and claims.

Multichannel Communications

Email, SMS, Push, Webhook, and Order Status Page delivery of branded post-purchase messages.

Apple Wallet Tracking

Native Apple Wallet passes for order tracking.

AI Agents

WISMO/R Agent, Insights Agent, and Fraud & Abuse Insights powered by ML over post-purchase data.

Insights & Benchmarking

Trackings Insights, Communication Insights, Control Tower, Logistics Analysis, and Benchmarking dashboards.

Surveys & NPS

Embedded surveys and NPS feedback tied to deliveries or return registrations.

MCP Server

Hosted Model Context Protocol server (agents.parcellab.com/mcp/) for agentic order tracking and return registration workflows.

Use Cases

WISMO Reduction

Cut "Where Is My Order" support contacts by proactively communicating tracking updates.

Returns as Retention

Convert returns into exchanges, store credit, or retention offers to keep revenue.

Cart Conversion

Display a delivery promise at checkout to reduce abandonment.

Cross-Border Returns

Provide customs handling and Global-e integration for unified cross-border returns.

Carrier Performance Benchmarking

Compare lead-times, exceptions, and on-time rates across the carrier portfolio.

Marketing in the Delivery Window

Embed branded campaigns and product recommendations in delivery communications.

Integrations

Shopify

Native Shopify integration for tracking, communications, and returns.

Magento 2

Webhook extension for Magento 2 storefronts.

Shopware

Embedded Order Status Page for Shopware shops.

Klaviyo

Route post-purchase email through Klaviyo journeys.

Postscript

Route post-purchase SMS through Postscript.

Zendesk

Customer service ticket sidebar with parcelLab tracking data.

Gorgias

Helpdesk widget displaying order and tracking data.

Kustomer

Helpdesk app for parcelLab delivery context.

Salesforce Service Cloud

Customer Service Integration surfacing parcelLab data in SFSC.

Global-e

Unified cross-border returns experience.

Apple Wallet

Native order tracking passes in Apple Wallet.

Poshmark

List non-returnable items directly from the Returns Portal onto Poshmark.

Solutions

Convert

Pre-checkout delivery promise module.

Engage

Multichannel post-purchase communication module.

Retain

Returns Portal and returns experience module.

Insights

Analytics, benchmarking, and control tower module.

AI Agents

Add-on autonomous agents for WISMO/R, insights, and fraud.

Semantic Vocabularies

Parcellab Context

25 classes · 0 properties

JSON-LD

API Governance Rules

parcelLab API Rules

7 rules · 2 errors 5 warnings

SPECTRAL

JSON Structure

Parcellab Order Structure

10 properties

JSON STRUCTURE

Parcellab Return Registration Structure

12 properties

JSON STRUCTURE

Example Payloads

Parcellab Create Return Registration Example

2 fields

EXAMPLE

Parcellab Get Order Info Example

2 fields

EXAMPLE

Parcellab Predict Delivery Example

2 fields

EXAMPLE

Parcellab Pudo Lookup Example

2 fields

EXAMPLE

Parcellab Upsert Order Example

2 fields

EXAMPLE

Resources

PostmanWorkspace

PostmanWorkspace

DeveloperPortal

DeveloperPortal

Documentation

GettingStarted

Authentication

APIReference

TermsOfService

GitHubOrganization

GitHubOrganization

SecurityCompliance

SecurityCompliance

SingleSignOn

DataRetentionPolicy

DataRetentionPolicy

SpectralRules

Sources

opencollection: 1.0.0
info:
  name: parcelLab API
  version: '4'
request:
  auth:
    type: apikey
    key: Authorization
    value: '{{Authorization}}'
    placement: header
items:
- info:
    name: Orders
    type: folder
  items:
  - info:
      name: Create or Update Order
      type: http
    http:
      method: PUT
      url: https://api.parcellab.com/v4/track/orders/
      body:
        type: json
        data: '{}'
    docs: Idempotent endpoint that creates a new order or applies mutations to an existing one (add or cancel trackings, change
      line item quantity, add or replace line items, cancel order).
  - info:
      name: Get Order Status
      type: http
    http:
      method: GET
      url: https://api.parcellab.com/v4/track/orders/info/
      params:
      - name: account
        value: ''
        type: query
      - name: order_number
        value: ''
        type: query
      - name: tracking_number
        value: ''
        type: query
      - name: courier
        value: ''
        type: query
      - name: external_order_id
        value: ''
        type: query
      - name: external_reference
        value: ''
        type: query
      - name: customer_number
        value: ''
        type: query
      - name: recipient_email
        value: ''
        type: query
      - name: recipient_postal_code
        value: ''
        type: query
      - name: client_key
        value: ''
        type: query
      - name: lang
        value: ''
        type: query
      - name: s
        value: ''
        type: query
        description: HMAC security signature.
      - name: live_refresh
        value: ''
        type: query
      - name: show_returns
        value: ''
        type: query
      - name: tracking_id
        value: ''
        type: query
      - name: single_tracking
        value: ''
        type: query
    docs: Retrieve the latest order, tracking, and checkpoint information for an order identified by order_number, tracking_number,
      external_order_id, or recipient identifiers.
- info:
    name: Events
    type: folder
  items:
  - info:
      name: Send Shop or Warehouse Event
      type: http
    http:
      method: POST
      url: https://api.parcellab.com/v4/track/events/
      body:
        type: json
        data: '{}'
    docs: Push a custom event/checkpoint (e.g., warehouse pick, pack, dispatch) into the order timeline. Identifies the order
      by courier+tracking, account+reference, or account+order_number.
- info:
    name: Place Info
    type: folder
  items:
  - info:
      name: Look Up Pickup/Drop-Off Locations
      type: http
    http:
      method: POST
      url: https://api.parcellab.com/v4/track/place-info/lookup/
      params:
      - name: account
        value: ''
        type: query
      - name: ordering
        value: ''
        type: query
      body:
        type: json
        data: '{}'
    docs: Find nearby PUDO points for one or more couriers, ranked by distance from a geo-coordinate or address.
- info:
    name: Promise
    type: folder
  items:
  - info:
      name: Predict Delivery Date
      type: http
    http:
      method: GET
      url: https://api.parcellab.com/v4/promise/prediction/predict/
      params:
      - name: account
        value: ''
        type: query
      - name: destination_country_iso3
        value: ''
        type: query
      - name: destination_postal_code
        value: ''
        type: query
      - name: courier
        value: ''
        type: query
      - name: service_level
        value: ''
        type: query
      - name: warehouse
        value: ''
        type: query
      - name: language_iso2
        value: ''
        type: query
      - name: calibration
        value: ''
        type: query
      - name: dispatch_now
        value: ''
        type: query
      - name: now_override
        value: ''
        type: query
      - name: draft
        value: ''
        type: query
    docs: Return localized delivery date predictions for a destination, optionally constrained to a courier, service level,
      and warehouse.
- info:
    name: Returns
    type: folder
  items:
  - info:
      name: List Return Registrations
      type: http
    http:
      method: GET
      url: https://api.parcellab.com/v4/returns/return-registrations/
      params:
      - name: account
        value: ''
        type: query
      - name: limit
        value: ''
        type: query
      - name: offset
        value: ''
        type: query
      - name: ordering
        value: ''
        type: query
    docs: List Return Registrations
  - info:
      name: Create Return Registration
      type: http
    http:
      method: POST
      url: https://api.parcellab.com/v4/returns/return-registrations/
      body:
        type: json
        data: '{}'
    docs: Create Return Registration
  - info:
      name: Get Return Registration
      type: http
    http:
      method: GET
      url: https://api.parcellab.com/v4/returns/return-registrations/:external_id/
      params:
      - name: external_id
        value: ''
        type: path
    docs: Get Return Registration
  - info:
      name: List Return Configurations
      type: http
    http:
      method: GET
      url: https://api.parcellab.com/v4/returns/returns-configurations/
      params:
      - name: account
        value: ''
        type: query
      - name: limit
        value: ''
        type: query
      - name: offset
        value: ''
        type: query
      - name: ordering
        value: ''
        type: query
    docs: List Return Configurations
  - info:
      name: Get Return Configuration
      type: http
    http:
      method: GET
      url: https://api.parcellab.com/v4/returns/returns-configurations/:id/
      params:
      - name: id
        value: ''
        type: path
    docs: Get Return Configuration
  - info:
      name: List Document Templates
      type: http
    http:
      method: GET
      url: https://api.parcellab.com/v4/returns/document-templates/
      params:
      - name: account
        value: ''
        type: query
      - name: limit
        value: ''
        type: query
      - name: offset
        value: ''
        type: query
    docs: Document templates used for generating return labels and slips.
- info:
    name: Campaigns
    type: folder
  items:
  - info:
      name: Evaluate Campaign Targeting
      type: http
    http:
      method: GET
      url: https://api.parcellab.com/v4/campaign/evaluate/
      params:
      - name: accountId
        value: ''
        type: query
      - name: campaignId
        value: ''
        type: query
      - name: language
        value: ''
        type: query
      - name: medium
        value: ''
        type: query
      - name: message
        value: ''
        type: query
      - name: orderNumber
        value: ''
        type: query
      - name: preview
        value: ''
        type: query
      - name: status
        value: ''
        type: query
      - name: trackingId
        value: ''
        type: query
    docs: Evaluate Campaign Targeting
  - info:
      name: Campaign Redirect Analytics
      type: http
    http:
      method: GET
      url: https://api.parcellab.com/v4/campaign/redirect/
      params:
      - name: campaignId
        value: ''
        type: query
      - name: trackingId
        value: ''
        type: query
      - name: eventType
        value: ''
        type: query
      - name: medium
        value: ''
        type: query
      - name: redirectUrl
        value: ''
        type: query
      - name: customerSegmentationId
        value: ''
        type: query
      - name: emailId
        value: ''
        type: query
      - name: contentType
        value: ''
        type: query
    docs: Campaign Redirect Analytics
- info:
    name: Surveys
    type: folder
  items:
  - info:
      name: Get Survey
      type: http
    http:
      method: GET
      url: https://api.parcellab.com/v4/survey/survey/:id/
      params:
      - name: id
        value: ''
        type: path
    docs: Get Survey
  - info:
      name: Get Survey Answer
      type: http
    http:
      method: GET
      url: https://api.parcellab.com/v4/survey/survey/:id/answer/
      params:
      - name: id
        value: ''
        type: path
      - name: ref_id
        value: ''
        type: query
      - name: reference_type
        value: ''
        type: query
    docs: Get Survey Answer
  - info:
      name: Submit Survey Answer
      type: http
    http:
      method: POST
      url: https://api.parcellab.com/v4/survey/survey/:id/answer/
      params:
      - name: id
        value: ''
        type: path
      body:
        type: json
        data: '{}'
    docs: Submit Survey Answer
  - info:
      name: List Survey Themes
      type: http
    http:
      method: GET
      url: https://api.parcellab.com/v4/survey/survey/themes/
      params:
      - name: default
        value: ''
        type: query
    docs: List Survey Themes
bundled: true