parcelLab

aid: parcellab
url: https://raw.githubusercontent.com/api-evangelist/parcellab/refs/heads/main/apis.yml
name: parcelLab
description: >-
  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.
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
tags:
  - Post-Purchase
  - E-Commerce
  - Tracking
  - Returns
  - Shipping
  - Delivery
  - Customer Experience
  - Logistics
  - Communications
  - Germany
created: '2026-05-25'
modified: '2026-05-25'
specificationVersion: '0.19'
type: Index
kind: contract
access: 3rd-Party
position: Producer
apis:
  - aid: parcellab:parcellab-api
    name: parcelLab API
    description: >-
      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 (Promise), creating and managing return
      registrations against returns configurations, evaluating campaign targeting, and serving surveys back to
      customers.
    humanURL: https://docs.parcellab.com/docs/developers/readme
    baseURL: https://api.parcellab.com
    tags:
      - Orders
      - Tracking
      - Returns
      - Promise
      - Surveys
      - Campaigns
      - PUDO
    properties:
      - type: Documentation
        url: https://docs.parcellab.com/docs/developers/readme
      - type: APIReference
        url: https://docs.parcellab.com/docs/developers/getting-started/api-reference
      - type: Quickstart
        url: https://docs.parcellab.com/docs/developers/getting-started/quickstart-guide
      - type: Authentication
        url: https://docs.parcellab.com/docs/developers/getting-started/authentication
      - type: OpenAPI
        url: openapi/parcellab-openapi.yml
      - type: JSONSchema
        url: json-schema/parcellab-order-schema.json
      - type: JSONSchema
        url: json-schema/parcellab-tracking-schema.json
      - type: JSONSchema
        url: json-schema/parcellab-return-registration-schema.json
      - type: JSONSchema
        url: json-schema/parcellab-address-schema.json
      - type: JSONSchema
        url: json-schema/parcellab-line-item-schema.json
      - type: JSONSchema
        url: json-schema/parcellab-promise-prediction-schema.json
      - type: JSONStructure
        url: json-structure/parcellab-order-structure.json
      - type: JSONStructure
        url: json-structure/parcellab-return-registration-structure.json
      - type: JSONLD
        url: json-ld/parcellab-context.jsonld
      - type: Example
        url: examples/parcellab-upsert-order-example.json
      - type: Example
        url: examples/parcellab-get-order-info-example.json
      - type: Example
        url: examples/parcellab-predict-delivery-example.json
      - type: Example
        url: examples/parcellab-create-return-registration-example.json
      - type: Example
        url: examples/parcellab-pudo-lookup-example.json
  - aid: parcellab:parcellab-mcp
    name: parcelLab MCP Server
    description: >-
      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 with scopes such as `track:orderinfo` and
      `returns:registration`.
    humanURL: https://github.com/parcelLab/parcellab-mcp-server
    baseURL: https://agents.parcellab.com/mcp/
    tags:
      - MCP
      - AI
      - Agents
      - Tracking
      - Returns
    properties:
      - type: GitHubRepository
        url: https://github.com/parcelLab/parcellab-mcp-server
      - type: Documentation
        url: https://github.com/parcelLab/parcellab-mcp-server
common:
  - type: PostmanWorkspace
    url: https://www.postman.com/kinlaneapi/parcellab/overview
  - type: ArazzoWorkflows
    url: arazzo/
    workflows:
      - url: arazzo/parcellab-create-and-fetch-return-workflow.yml
        name: parcelLab Create and Fetch Return
        summary: Create a return registration and immediately read it back by external id.
      - url: arazzo/parcellab-evaluate-campaign-and-redirect-workflow.yml
        name: parcelLab Evaluate Campaign and Log Redirect
        summary: Evaluate campaign targeting for a tracking, then record a redirect analytics event.
      - url: arazzo/parcellab-list-and-get-return-workflow.yml
        name: parcelLab List and Get Return
        summary: List return registrations for an account, then fetch the first one in detail.
      - url: arazzo/parcellab-predict-then-create-order-workflow.yml
        name: parcelLab Predict Delivery and Create Order
        summary: Get a pre-checkout delivery prediction, then create the order it describes.
      - url: arazzo/parcellab-pudo-lookup-and-register-return-workflow.yml
        name: parcelLab PUDO Lookup and Register Return
        summary: Find a nearby drop-off point, then open a return registration for the order.
      - url: arazzo/parcellab-register-return-and-survey-workflow.yml
        name: parcelLab Register Return and Collect Survey
        summary: Create a return registration, then submit a survey response tied to it.
      - url: arazzo/parcellab-resolve-config-and-register-return-workflow.yml
        name: parcelLab Resolve Config and Register Return
        summary: Resolve a return configuration for an account, then register a return with it.
      - url: arazzo/parcellab-send-event-and-refresh-workflow.yml
        name: parcelLab Send Event and Refresh Status
        summary: Push a warehouse or shop event into the timeline, then refresh the order status.
      - url: arazzo/parcellab-survey-fetch-and-submit-workflow.yml
        name: parcelLab Survey Fetch and Submit
        summary: Load a survey, fetch its prefilled answers for a reference, then submit a response.
      - url: arazzo/parcellab-track-and-target-campaign-workflow.yml
        name: parcelLab Track and Target Campaign
        summary: Read an order's tracking status, then evaluate a campaign for that tracking.
      - url: arazzo/parcellab-upsert-order-and-track-workflow.yml
        name: parcelLab Create Order and Track
        summary: Create or update an order, then retrieve its latest tracking and checkpoints.
  - type: Website
    url: https://parcellab.com
  - type: DeveloperPortal
    url: https://docs.parcellab.com/docs/developers/readme
  - type: Documentation
    url: https://docs.parcellab.com/docs/readme
  - type: GettingStarted
    url: https://docs.parcellab.com/docs/onboarding
  - type: Authentication
    url: https://docs.parcellab.com/docs/developers/getting-started/authentication
  - type: APIReference
    url: https://docs.parcellab.com/docs/developers/getting-started/api-reference
  - type: ErrorCodes
    url: https://docs.parcellab.com/docs/developers/getting-started/error-codes
  - type: SignUp
    url: https://app.parcellab.com/signin
  - type: Console
    url: https://app.parcellab.com
  - type: StatusPage
    url: https://status.parcellab.com
  - type: Pricing
    url: https://parcellab.com/contact-us
  - type: Blog
    url: https://parcellab.com/blog/
  - type: TermsOfService
    url: https://parcellab.com/legal/terms-of-service/
  - type: Careers
    url: https://parcellab.com/careers
  - type: Support
    url: https://parcellab.com/contact-us
  - type: GitHubOrganization
    url: https://github.com/parcelLab
  - type: LinkedIn
    url: https://www.linkedin.com/company/parcellab
  - type: SecurityCompliance
    url: https://docs.parcellab.com/docs/platform/security-compliance
  - type: SingleSignOn
    url: https://docs.parcellab.com/docs/platform/security-compliance/single-sign-on
  - type: DataRetentionPolicy
    url: https://docs.parcellab.com/docs/platform/security-compliance/data-retention-policy
  - type: SDK
    url: https://github.com/parcelLab/parcelLab-js-plugin
  - type: SDK
    url: https://github.com/parcelLab/js-plugin-utils
  - type: SDK
    url: https://github.com/parcelLab/regionIdentifier
  - type: SDK
    url: https://github.com/parcelLab/parcellab-embedded-ui-snippets
  - type: SDK
    url: https://github.com/parcelLab/charts
  - type: AgentSDK
    url: https://github.com/parcelLab/parcellab-mcp-server
  - type: Plans
    url: plans/parcellab-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/parcellab-rate-limits.yml
  - type: FinOps
    url: finops/parcellab-finops.yml
  - type: SpectralRules
    url: rules/parcellab-rules.yml
  - type: Vocabulary
    url: vocabulary/parcellab-vocabulary.yml
  - type: Features
    data:
      - name: Delivery Promise
        description: Pre-checkout delivery date prediction (Promise API) to drive cart conversion.
      - name: Order & Tracking Ingestion
        description: Idempotent v4 Orders API with mutations to add/cancel trackings or amend line items.
      - name: Carrier Network
        description: Integrations with 450+ carriers worldwide via direct carrier interfaces.
      - name: Returns Portal
        description: >-
          Branded self-service returns portal with refund options, exchanges, retention offers, split returns, and
          claims.
      - name: Multichannel Communications
        description: Email, SMS, Push, Webhook, and Order Status Page delivery of branded post-purchase messages.
      - name: Apple Wallet Tracking
        description: Native Apple Wallet passes for order tracking.
      - name: AI Agents
        description: WISMO/R Agent, Insights Agent, and Fraud & Abuse Insights powered by ML over post-purchase data.
      - name: Insights & Benchmarking
        description: Trackings Insights, Communication Insights, Control Tower, Logistics Analysis, and Benchmarking dashboards.
      - name: Surveys & NPS
        description: Embedded surveys and NPS feedback tied to deliveries or return registrations.
      - name: MCP Server
        description: >-
          Hosted Model Context Protocol server (agents.parcellab.com/mcp/) for agentic order tracking and return
          registration workflows.
  - type: UseCases
    data:
      - name: WISMO Reduction
        description: Cut "Where Is My Order" support contacts by proactively communicating tracking updates.
      - name: Returns as Retention
        description: Convert returns into exchanges, store credit, or retention offers to keep revenue.
      - name: Cart Conversion
        description: Display a delivery promise at checkout to reduce abandonment.
      - name: Cross-Border Returns
        description: Provide customs handling and Global-e integration for unified cross-border returns.
      - name: Carrier Performance Benchmarking
        description: Compare lead-times, exceptions, and on-time rates across the carrier portfolio.
      - name: Marketing in the Delivery Window
        description: Embed branded campaigns and product recommendations in delivery communications.
  - type: Integrations
    data:
      - name: Shopify
        description: Native Shopify integration for tracking, communications, and returns.
      - name: Magento 2
        description: Webhook extension for Magento 2 storefronts.
      - name: Shopware
        description: Embedded Order Status Page for Shopware shops.
      - name: Klaviyo
        description: Route post-purchase email through Klaviyo journeys.
      - name: Postscript
        description: Route post-purchase SMS through Postscript.
      - name: Zendesk
        description: Customer service ticket sidebar with parcelLab tracking data.
      - name: Gorgias
        description: Helpdesk widget displaying order and tracking data.
      - name: Kustomer
        description: Helpdesk app for parcelLab delivery context.
      - name: Salesforce Service Cloud
        description: Customer Service Integration surfacing parcelLab data in SFSC.
      - name: Global-e
        description: Unified cross-border returns experience.
      - name: Apple Wallet
        description: Native order tracking passes in Apple Wallet.
      - name: Poshmark
        description: List non-returnable items directly from the Returns Portal onto Poshmark.
  - type: Solutions
    data:
      - name: Convert
        description: Pre-checkout delivery promise module.
      - name: Engage
        description: Multichannel post-purchase communication module.
      - name: Retain
        description: Returns Portal and returns experience module.
      - name: Insights
        description: Analytics, benchmarking, and control tower module.
      - name: AI Agents
        description: Add-on autonomous agents for WISMO/R, insights, and fraud.
  - type: Offices
    data:
      - name: Munich (HQ)
        description: parcelLab GmbH — Kapellenweg 6, 81371 Munich, Germany.
      - name: Boston
        description: 75 State Street, Boston, MA 02109, USA.
      - name: London
        description: Moor Place, 1 Fore Street Avenue, London EC2Y 9DT, UK.
      - name: Paris
        description: 24-26 Rue De la Pépinière, 75008 Paris, France.
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com