parcelLab website screenshot

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.

parcelLab publishes 7 APIs on the APIs.io network, including Campaigns API, Events API, Orders API, and 4 more. Tagged areas include Post-Purchase, E-Commerce, Tracking, Returns, and Shipping.

The parcelLab catalog on APIs.io includes 1 JSON-LD context and 2 Spectral governance rulesets.

parcelLab’s developer surface includes authentication, documentation, getting-started guide, API reference, signup flow, developer console, pricing, and 40 more developer resources.

66.9/100 exemplar ▼ -5.2 Agent 34/100 agent ready Full breakdown ↓
scored 2026-07-28 · rubric v0.6
AccessSelf serve
8 APIs 10 Features 6 Use Cases
Post-PurchaseE-CommerceTrackingReturnsShippingDeliveryCustomer ExperienceLogisticsCommunicationsGermany

Kin Score

Kin Score Kin Score How this is scored →
scored 2026-07-28 · rubric v0.6
Composite quality — 66.9/100 · exemplar
Contract Quality 18.1 / 25
Developer Ergonomics 15.7 / 20
Commercial Clarity 12.1 / 20
Operational Transparency 5.5 / 13
Governance 8.3 / 12
Discoverability 7.4 / 10
Agent readiness — 34/100 · agent ready
Machine-Readable Contract 18 / 18
Agentic Access Contract 10 / 10
MCP Server 0 / 12
Machine-Readable Auth 10 / 10
Idempotency 0 / 9
Stable Error Semantics 8 / 8
Request/Response Examples 0 / 7
Rate-Limit Signaling 7 / 7
Typed Event Surface 0 / 6
Agent Skills 0 / 5
Well-Known Catalog 0 / 4
Consent & Bot Identity 0 / 3
A2A Agent Card 0 / 8
Dry-Run / Simulate Mode 0 / 4
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/parcellab: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 8

Individual APIs this provider publishes, each with its own machine-readable definition.

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 ...

parcelLab Campaigns API

Evaluate campaign targeting and redirect analytics events.

parcelLab Events API

Send custom shop or warehouse events into the tracking timeline.

parcelLab Orders API

Create, update, and inspect orders and their trackings.

parcelLab Place Info API

Look up nearby pickup and drop-off (PUDO) locations.

parcelLab Promise API

Pre-checkout delivery date predictions.

parcelLab Returns API

Return registrations, configurations, and document templates.

parcelLab Surveys API

Retrieve survey definitions and submit responses.

Scroll for all 8

Postman Collections 1

Ready-to-run Postman collections for exercising this provider's APIs.

parcelLab API

POSTMAN

Open Collections 1

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

parcelLab API

OPEN COLLECTION

Arazzo Workflows 11

Multi-step API workflows described with the Arazzo specification.

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

Scroll for all 11

Pricing Plans 1

Published pricing tiers and plan structures.

Rate Limits 1

Documented rate limits and quota policies.

Parcellab Rate Limits

2 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

Features 10

Notable capabilities this provider offers.

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.

Scroll for all 10

Semantic Vocabularies 1

JSON-LD contexts and semantic vocabularies used across these APIs.

Parcellab Context

25 classes · 0 properties

JSON-LD

Spectral Rules 2

Spectral governance rulesets for linting and validating these APIs.

parcelLab API Rules

5 rules · 4 warnings 1 info

SPECTRAL

parcelLab API Rules

7 rules · 2 errors 5 warnings

SPECTRAL

JSON Schema 6

Standalone JSON Schema definitions for this provider's data models.

parcelLab Address

9 properties

JSON SCHEMA

parcelLab Line Item

7 properties

JSON SCHEMA

parcelLab Order

11 properties

JSON SCHEMA

parcelLab Promise Prediction

3 properties

JSON SCHEMA

parcelLab Return Registration

22 properties

JSON SCHEMA

parcelLab Tracking

6 properties

JSON SCHEMA

JSON Structure 2

JSON Structure definitions describing this provider's data shapes.

Parcellab Order Structure

10 properties

JSON STRUCTURE

Parcellab Return Registration Structure

12 properties

JSON STRUCTURE

Examples 5

Example request and response payloads for these APIs.

Security Posture 3

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Parcellab Authentication

apiKey · 1 scheme

SECURITY

Parcellab Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Parcellab Vulnerability Disclosure

security.txt · contact published

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Parcellab Agentic Access

17 operations · 5 acting

17 operations · 5 acting

AGENTIC

Use Cases 6

What developers build with this provider.

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 12

Pre-built integrations with other platforms and tools.

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.

Scroll for all 12

Solutions 5

Packaged solutions this provider offers.

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.

Resources

Get Started 4

Portal, sign-up, and the first successful call

Documentation 2

Reference material describing how the API behaves

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

Design & Contract 14

Pagination, idempotency, versioning, errors, and events

Scroll for all 14

Build 8

SDKs, sample code, and the tooling you integrate with

Scroll for all 8

Access & Security 5

Authentication, authorization, and security posture

Operate 3

Status, limits, changes, and where to get help

Commercial 4

Pricing, plans, and the legal terms of use

Company 4

The organization behind the API

Other 3

Properties that don't map to a standard resource type

Source (apis.yml)

apis.yml Raw ↑
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.
accessModel:
  pricing: unknown
  onboarding: self-serve
  trial: false
  try_now: false
  public: false
  label: Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/parcellab.png
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-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
- aid: parcellab:parcellab-campaigns-api
  name: parcelLab Campaigns API
  description: Evaluate campaign targeting and redirect analytics events.
  humanURL: https://docs.parcellab.com/docs/developers/readme
  baseURL: https://api.parcellab.com
  tags:
  - Campaigns
  properties:
  - type: OpenAPI
    url: openapi/parcellab-campaigns-api-openapi.yml
  - type: Documentation
    url: https://docs.parcellab.com/docs/developers/readme
  - type: APIReference
    url: https://docs.parcellab.com/docs/developers/getting-started/api-reference
  - type: GettingStarted
    url: https://docs.parcellab.com/docs/developers/getting-started/quickstart-guide
  - type: Authentication
    url: https://docs.parcellab.com/docs/developers/getting-started/authentication
  - 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: Examples
    url: examples/parcellab-upsert-order-example.json
  - type: Examples
    url: examples/parcellab-get-order-info-example.json
  - type: Examples
    url: examples/parcellab-predict-delivery-example.json
  - type: Examples
    url: examples/parcellab-create-return-registration-example.json
  - type: Examples
    url: examples/parcellab-pudo-lookup-example.json
- aid: parcellab:parcellab-events-api
  name: parcelLab Events API
  description: Send custom shop or warehouse events into the tracking timeline.
  humanURL: https://docs.parcellab.com/docs/developers/readme
  baseURL: https://api.parcellab.com
  tags:
  - Events
  properties:
  - type: OpenAPI
    url: openapi/parcellab-events-api-openapi.yml
  - type: Documentation
    url: https://docs.parcellab.com/docs/developers/readme
  - type: APIReference
    url: https://docs.parcellab.com/docs/developers/getting-started/api-reference
  - type: GettingStarted
    url: https://docs.parcellab.com/docs/developers/getting-started/quickstart-guide
  - type: Authentication
    url: https://docs.parcellab.com/docs/developers/getting-started/authentication
  - 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: Examples
    url: examples/parcellab-upsert-order-example.json
  - type: Examples
    url: examples/parcellab-get-order-info-example.json
  - type: Examples
    url: examples/parcellab-predict-delivery-example.json
  - type: Examples
    url: examples/parcellab-create-return-registration-example.json
  - type: Examples
    url: examples/parcellab-pudo-lookup-example.json
- aid: parcellab:parcellab-orders-api
  name: parcelLab Orders API
  description: Create, update, and inspect orders and their trackings.
  humanURL: https://docs.parcellab.com/docs/developers/readme
  baseURL: https://api.parcellab.com
  tags:
  - Orders
  properties:
  - type: OpenAPI
    url: openapi/parcellab-orders-api-openapi.yml
  - type: Documentation
    url: https://docs.parcellab.com/docs/developers/readme
  - type: APIReference
    url: https://docs.parcellab.com/docs/developers/getting-started/api-reference
  - type: GettingStarted
    url: https://docs.parcellab.com/docs/developers/getting-started/quickstart-guide
  - type: Authentication
    url: https://docs.parcellab.com/docs/developers/getting-started/authentication
  - 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: Examples
    url: examples/parcellab-upsert-order-example.json
  - type: Examples
    url: examples/parcellab-get-order-info-example.json
  - type: Examples
    url: examples/parcellab-predict-delivery-example.json
  - type: Examples
    url: examples/parcellab-create-return-registration-example.json
  - type: Examples
    url: examples/parcellab-pudo-lookup-example.json
- aid: parcellab:parcellab-place-info-api
  name: parcelLab Place Info API
  description: Look up nearby pickup and drop-off (PUDO) locations.
  humanURL: https://docs.parcellab.com/docs/developers/readme
  baseURL: https://api.parcellab.com
  tags:
  - Place Info
  properties:
  - type: OpenAPI
    url: openapi/parcellab-place-info-api-openapi.yml
  - type: Documentation
    url: https://docs.parcellab.com/docs/developers/readme
  - type: APIReference
    url: https://docs.parcellab.com/docs/developers/getting-started/api-reference
  - type: GettingStarted
    url: https://docs.parcellab.com/docs/developers/getting-started/quickstart-guide
  - type: Authentication
    url: https://docs.parcellab.com/docs/developers/getting-started/authentication
  - 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: Examples
    url: examples/parcellab-upsert-order-example.json
  - type: Examples
    url: examples/parcellab-get-order-info-example.json
  - type: Examples
    url: examples/parcellab-predict-delivery-example.json
  - type: Examples
    url: examples/parcellab-create-return-registration-example.json
  - type: Examples
    url: examples/parcellab-pudo-lookup-example.json
- aid: parcellab:parcellab-promise-api
  name: parcelLab Promise API
  description: Pre-checkout delivery date predictions.
  humanURL: https://docs.parcellab.com/docs/developers/readme
  baseURL: https://api.parcellab.com
  tags:
  - Promise
  properties:
  - type: OpenAPI
    url: openapi/parcellab-promise-api-openapi.yml
  - type: Documentation
    url: https://docs.parcellab.com/docs/developers/readme
  - type: APIReference
    url: https://docs.parcellab.com/docs/developers/getting-started/api-reference
  - type: GettingStarted
    url: https://docs.parcellab.com/docs/developers/getting-started/quickstart-guide
  - type: Authentication
    url: https://docs.parcellab.com/docs/developers/getting-started/authentication
  - 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: Examples
    url: examples/parcellab-upsert-order-example.json
  - type: Examples
    url: examples/parcellab-get-order-info-example.json
  - type: Examples
    url: examples/parcellab-predict-delivery-example.json
  - type: Examples
    url: examples/parcellab-create-return-registration-example.json
  - type: Examples
    url: examples/parcellab-pudo-lookup-example.json
- aid: parcellab:parcellab-returns-api
  name: parcelLab Returns API
  description: Return registrations, configurations, and document templates.
  humanURL: https://docs.parcellab.com/docs/developers/readme
  baseURL: https://api.parcellab.com
  tags:
  - Returns
  properties:
  - type: OpenAPI
    url: openapi/parcellab-returns-api-openapi.yml
  - type: Documentation
    url: https://docs.parcellab.com/docs/developers/readme
  - type: APIReference
    url: https://docs.parcellab.com/docs/developers/getting-started/api-reference
  - type: GettingStarted
    url: https://docs.parcellab.com/docs/developers/getting-started/quickstart-guide
  - type: Authentication
    url: https://docs.parcellab.com/docs/developers/getting-started/authentication
  - 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: Examples
    url: examples/parcellab-upsert-order-example.json
  - type: Examples
    url: examples/parcellab-get-order-info-example.json
  - type: Examples
    url: examples/parcellab-predict-delivery-example.json
  - type: Examples
    url: examples/parcellab-create-return-registration-example.json
  - type: Examples
    url: examples/parcellab-pudo-lookup-example.json
- aid: parcellab:parcellab-surveys-api
  name: parcelLab Surveys API
  description: Retrieve survey definitions and submit responses.
  humanURL: https://docs.parcellab.com/docs/developers/readme
  baseURL: https://api.parcellab.com
  tags:
  - Surveys
  properties:
  - type: OpenAPI
    url: openapi/parcellab-surveys-api-openapi.yml
  - type: Documentation
    url: https://docs.parcellab.com/docs/developers/readme
  - type: APIReference
    url: https://docs.parcellab.com/docs/developers/getting-started/api-reference
  - type: GettingStarted
    url: https://docs.parcellab.com/docs/developers/getting-started/quickstart-guide
  - type: Authentication
    url: https://docs.parcellab.com/docs/developers/getting-started/authentication
  - 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: Examples
    url: examples/parcellab-upsert-order-example.json
  - type: Examples
    url: examples/parcellab-get-order-info-example.json
  - type: Examples
    url: examples/parcellab-predict-delivery-example.json
  - type: Examples
    url: examples/parcellab-create-return-registration-example.json
  - type: Examples
    url: examples/parcellab-pudo-lookup-example.json
common:
- type: AgenticAccess
  url: agentic-access/parcellab-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/parcellab-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/parcellab-domain-security.yml
- type: Authentication
  url: authentication/parcellab-authentication.yml
- type: PostmanWorkspace
  url: https://www.postman.com/kinlaneapi/parcellab/overview
- type: Arazzo
  url: arazzo/parcellab-create-and-fetch-return-workflow.yml
  name: parcelLab Create and Fetch Return
- type: Arazzo
  url: arazzo/parcellab-evaluate-campaign-and-redirect-workflow.yml
  name: parcelLab Evaluate Campaign and Log Redirect
- type: Arazzo
  url: arazzo/parcellab-list-and-get-return-workflow.yml
  name: parcelLab List and Get Return
- type: Arazzo
  url: arazzo/parcellab-predict-then-create-order-workflow.yml
  name: parcelLab Predict Delivery and Create Order
- type: Arazzo
  url: arazzo/parcellab-pudo-lookup-and-register-return-workflow.yml
  name: parcelLab PUDO Lookup and Register Return
- type: Arazzo
  url: arazzo/parcellab-register-return-and-survey-workflow.yml
  name: parcelLab Register Return and Collect Survey
- type: Arazzo
  url: arazzo/parcellab-resolve-config-and-register-return-workflow.yml
  name: parcelLab Resolve Config and Register Return
- type: Arazzo
  url: arazzo/parcellab-send-event-and-refresh-workflow.yml
  name: parcelLab Send Event and Refresh Status
- type: Arazzo
  url: arazzo/parcellab-survey-fetch-and-submit-workflow.yml
  name: parcelLab Survey Fetch and Submit
- type: Arazzo
  url: arazzo/parcellab-track-and-target-campaign-workflow.yml
  name: parcelLab Track and Target Campaign
- type: Arazzo
  url: arazzo/parcellab-upsert-order-and-track-workflow.yml
  name: parcelLab Create Order and Track
- 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: SDKs
  url: https://github.com/parcelLab/parcelLab-js-plugin
- type: SDKs
  url: https://github.com/parcelLab/js-plugin-utils
- type: SDKs
  url: https://github.com/parcelLab/regionIdentifier
- type: SDKs
  url: https://github.com/parcelLab/parcellab-embedded-ui-snippets
- type: SDKs
  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