# parcelLab Return Registration API

**Canonical:** https://apis.io/apis/parcellab/parcellab-return-registration-api/  
**Provider:** parcelLab — https://apis.io/providers/parcellab/  
**Base URL:** https://agents.parcellab.com/mcp/  
**Documentation:** https://github.com/parcelLab/parcellab-mcp-server

parcelLab Return Registration API is one of 17 APIs that [parcelLab](https://apis.io/providers/parcellab/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 8 JSON Schema definitions. Tagged areas include Return Registration. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, a JSON-LD context, and 8 JSON Schemas.

The Return Registration API from parcelLab — 14 operation(s) for return registration.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/v4/returns/return-registrations/` | List Return Registration |
| POST | `/v4/returns/return-registrations/` | Register Return |
| GET | `/v4/returns/return-registrations/{external_id}/` | Retrieve Return Registration |
| PUT | `/v4/returns/return-registrations/{external_id}/` | Update Return Registration |
| PATCH | `/v4/returns/return-registrations/{external_id}/` | Partially Update Return Registration |
| POST | `/v4/returns/return-registrations/{external_id}/add-label/` | Add Additional Label |
| GET | `/v4/returns/return-registrations/{external_id}/article-info/` | Retrieve Article Info |
| PATCH | `/v4/returns/return-registrations/{external_id}/article-info/` | Validate Article Info (Return items) |
| POST | `/v4/returns/return-registrations/{external_id}/exchange-product-options/` | Retrieve or validate exchange product options |
| POST | `/v4/returns/return-registrations/{external_id}/mutate/` | Mutate Return Registration |
| POST | `/v4/returns/return-registrations/{external_id}/receive/` | Receive and close a return registration |
| POST | `/v4/returns/return-registrations/{external_id}/receive-label/` | Receive one return label |
| GET | `/v4/returns/return-registrations/{external_id}/return-options/` | Retrieve Return Options |
| POST | `/v4/returns/return-registrations/{external_id}/return-options/` | Apply Return Option |
| GET | `/v4/returns/return-registrations/{external_id}/return-options/pickup-availability/` | Retrieve Pickup Availability |
| GET | `/v4/returns/return-registrations/{external_id}/status/` | Retrieve Return Status |
| POST | `/v4/returns/return-registrations/{external_id}/submit/` | Submit Return Registration |
| POST | `/v4/returns/return-registrations/lookup-order/` | Create Return Registration (from order) |
| POST | `/v4/returns/return-registrations/mutate/` | Mutate Return Registration (Batch) |

## Machine-readable artifacts (19)

- **OpenAPI** — https://artifacts.apis.io/parcellab/openapi/parcellab-return-registration-api-openapi.yml
- **Documentation** — https://docs.parcellab.com/docs/developers/readme
- **APIReference** — https://docs.parcellab.com/docs/developers/getting-started/api-reference
- **GettingStarted** — https://docs.parcellab.com/docs/developers/getting-started/quickstart-guide
- **Authentication** — https://docs.parcellab.com/docs/developers/getting-started/authentication
- **JSONSchema** — https://artifacts.apis.io/parcellab/json-schema/parcellab-order-schema.json
- **JSONSchema** — https://artifacts.apis.io/parcellab/json-schema/parcellab-tracking-schema.json
- **JSONSchema** — https://artifacts.apis.io/parcellab/json-schema/parcellab-return-registration-schema.json
- **JSONSchema** — https://artifacts.apis.io/parcellab/json-schema/parcellab-address-schema.json
- **JSONSchema** — https://artifacts.apis.io/parcellab/json-schema/parcellab-line-item-schema.json
- **JSONSchema** — https://artifacts.apis.io/parcellab/json-schema/parcellab-promise-prediction-schema.json
- **JSONStructure** — https://artifacts.apis.io/parcellab/json-structure/parcellab-order-structure.json
- **JSONStructure** — https://artifacts.apis.io/parcellab/json-structure/parcellab-return-registration-structure.json
- **JSONLD** — https://artifacts.apis.io/parcellab/json-ld/parcellab-context.jsonld
- **Examples** — https://artifacts.apis.io/parcellab/examples/parcellab-upsert-order-example.json
- **Examples** — https://artifacts.apis.io/parcellab/examples/parcellab-get-order-info-example.json
- **Examples** — https://artifacts.apis.io/parcellab/examples/parcellab-predict-delivery-example.json
- **Examples** — https://artifacts.apis.io/parcellab/examples/parcellab-create-return-registration-example.json
- **Examples** — https://artifacts.apis.io/parcellab/examples/parcellab-pudo-lookup-example.json

## Other parcelLab APIs (12)

- [parcelLab MCP Server](https://apis.io/apis/parcellab/parcellab-mcp/)
- [parcelLab Events API](https://apis.io/apis/parcellab/parcellab-events-api/)
- [parcelLab Place Info API](https://apis.io/apis/parcellab/parcellab-place-info-api/)
- [parcelLab Promise API](https://apis.io/apis/parcellab/parcellab-promise-api/)
- [parcelLab Agents API](https://apis.io/apis/parcellab/parcellab-agents-api/)
- [parcelLab Apps API](https://apis.io/apis/parcellab/parcellab-apps-api/)
- [parcelLab Campaign API](https://apis.io/apis/parcellab/parcellab-campaign-api/)
- [parcelLab Customer Portals API](https://apis.io/apis/parcellab/parcellab-customer-portals-api/)
- [parcelLab Order API](https://apis.io/apis/parcellab/parcellab-order-api/)
- [parcelLab Order Status Page Theme API](https://apis.io/apis/parcellab/parcellab-order-status-page-theme-api/)
- [parcelLab Return Configuration Set API](https://apis.io/apis/parcellab/parcellab-return-configuration-set-api/)
- [parcelLab Size Recommender API](https://apis.io/apis/parcellab/parcellab-size-recommender-api/)

## Tags

Return Registration

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/parcellab/parcellab-return-registration-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/parcellab/.
