# Get a Return

## Get Return

<mark style="color:blue;">`GET`</mark> `http://wms.eshopbox.com/api/return-shipment/{customerReturnNumber}`

This endpoint allows you to get a return.

#### Path Parameters

| Name                 | Type   | Description               |
| -------------------- | ------ | ------------------------- |
| customerReturnNumber | string | Return Number of an order |

#### Headers

| Name           | Type   | Description                              |
| -------------- | ------ | ---------------------------------------- |
| Authentication | string | Bearer Token to grant access to this API |

{% tabs %}
{% tab title="200 Return successfully retrieved." %}

```php
{
    "externalChannelID": "TATA CLIQ VELOCY KAPAS KRAFT",
    "customerReturnNumber": "R4191129_1",
    "customerOrderNumber": "300975272",
    "order_id": 1564960,
    "pickupType": "reverse",
    "status": "CREATED",
    "refundAmount": 0,
    "cp_id": 24,
    "channel_id": 5,
    "trackingID": "573307721",
    "courierName": "EcomExpress Reverse",
    "customerName": "Sam",
    "customerContactNumber": "9999999999",
    "email": "sam@gmail.com",
    "remarks": "Soft data uploaded",
    "isCOD": "1",
    "channelSlug": "KAPAS KRAFT",
    "accountSlug": "KAPAS KRAFT",
    "pickupAddress": {
        "pickup_customerName": "Sam",
        "pickup_addressLine1": "Green Soul, reliable space",
        "pickup_addressLine2": "thane",
        "pickup_city": "Thane",
        "pickup_state": "Maharashtra",
        "pickup_postalCode": "421501",
        "pickup_countryCode": "IN",
        "pickup_countryName": "India",
        "pickup_contactPhone": "999999999",
        "pickup_email": "sam@gmail.com"
    },
    "dropAddress": {
        "drop_name": "Eshopbox Gurgaon (Sohna)",
        "drop_address": "MJ Logistics Private Limited, Seabird Marine Services Pvt Ltd,Village Babra Bakirpur, Pataudi Road Near Adani Logistic Park,  ICD Patli, Gurgaon, Haryana(122503)",
        "drop_pincode": "122503",
        "drop_city": "Gurgaon",
        "drop_country": "India",
        "drop_state": "Haryana"
    },
    "latest_status": "order_placed",
    "status_updated_at": "2020-07-09 17:54:20",
    "status_log": {
        "order_placed": "2020-07-09 17:54:20",
        "created": "2020-07-09 17:10:14"
    },
    "items": [
        {
            "lineItemSequenceNumber": 116833,
            "orderItemID": "300975273736427",
            "itemID": "5050410512025",
            "productName": "Ellison Bay",
            "quantity": 1,
            "lineItemTotal": 5499,
            "discount": 0,
            "returnReason": "Not satisfied with size or fit",
            "item_image": "CA001CL95LVWCLRKS-90678.jpg",
            "additionalInfo": {
                "image": null,
                "comments": null
            },
            "returnType": "refund",
            "productImageUrl": null,
            "productAdditionalInfo": null,
            "shippingCharges": 0,
            "productUrl": null,
            "isExchange": "0",
            "originalOrderItemId": null
        },
        {
            "lineItemSequenceNumber": 116834,
            "orderItemID": "300975273736428",
            "itemID": "5050407050417",
            "productName": "Sift 92",
            "quantity": 1,
            "lineItemTotal": 4199,
            "discount": 0,
            "returnReason": "Not satisfied with size or fit",
            "item_image": "CA001CL95LVWCLRKS-90678.jpg",
            "additionalInfo": {
                "image": null,
                "comments": null
            },
            "returnType": "refund",
            "productImageUrl": null,
            "productAdditionalInfo": null,
            "shippingCharges": 0,
            "productUrl": null,
            "isExchange": "0",
            "originalOrderItemId": null
        },
        {
            "lineItemSequenceNumber": 116835,
            "orderItemID": "300975272-3736429",
            "itemID": "5050407011906",
            "productName": "Sift 92",
            "quantity": 1,
            "lineItemTotal": 4199,
            "discount": 0,
            "returnReason": "Not satisfied with size or fit",
            "item_image": "CA001CL95LVWCLRKS-90678.jpg",
            "additionalInfo": {
                "image": null,
                "comments": null
            },
            "returnType": "refund",
            "productImageUrl": null,
            "productAdditionalInfo": null,
            "shippingCharges": 0,
            "productUrl": null,
            "isExchange": "0",
            "originalOrderItemId": null
        }
    ]
}
```

{% endtab %}
{% endtabs %}

```php
curl -X GET http://wms.eshopbox.com/api/return-shipment/{customerReturnNumber}\
-H "Authorization: Bearer XXXX" \
    -H "Content-Type: application/json" \
    -d $'{}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://eshop.gitbook.io/eshopbox-developers/order/returns/get-a-return.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.