> ## Documentation Index
> Fetch the complete documentation index at: https://docs.itshandled.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Handled Core Returns API Documentation

# Handled Core Returns API

The Handled Returns API provides comprehensive functionality for managing product returns throughout their entire lifecycle.

## Base URL

```
https://y5owe.hatchboxapp.com/v1
```

## Key Features

* **Return Management** - Create and track return requests from initiation to completion
* **Package Processing** - Handle physical return packages through your warehouse
* **Configuration** - Set up return policies, reasons, and processing workflows
* **Customer Portal** - Enable self-service returns for your customers
* **Real-time Updates** - Webhooks for return status changes

## API Structure

The API is organized into the following sections:

<CardGroup>
  <Card title="Authentication" icon="lock" href="/api-reference/authentication">
    Secure API access with Bearer tokens
  </Card>

  <Card title="Core Returns" icon="rotate-left" href="/api-reference/returns/get">
    Manage return requests and lifecycle
  </Card>

  <Card title="Return Packages" icon="box" href="/api-reference/packages/list">
    Track physical return shipments
  </Card>
</CardGroup>

## Getting Started

1. **Get your API credentials** from the Handled dashboard
2. **Review the Authentication guide** to understand request signing
3. **Explore the Core Returns endpoints** to create your first return
4. **Set up webhooks** to receive real-time updates

## Support

* **Documentation**: [docs.itshandled.ai](https://docs.itshandled.ai)
* **API Status**: [status.itshandled.ai](https://status.itshandled.ai)
* **Support**: [support@itshandled.ai](mailto:support@itshandled.ai)