Announcing returns
API reference ReturnShipmentAnnouncedAPI
Overview
Announce a return by calling this endpoint. After some seconds you will receive a label in the provided email.
Method access
POST https://api.getbyrd.com/v2/returns/announce
Request Headers
Authorization: Bearer token-from >
Authentication
Content-Type: application/json
User-Agent: your user-agent >
How to call the APIs
Fields
Field | Type | Description | Required |
---|---|---|---|
shipmentID | string | The shipment id to return. | always |
sendDocumentsToEmail | Email that will receive the return label. | always | |
itemsAnnounced | items announced object | Items to be returned | always |
Items announced object
Field | Type | Description | Required |
---|---|---|---|
shipmentItemID | string | The shipment item id to return. | always |
amount | integer | Email to send the return label. | always |
reason | string | Reason of the return for the item. | always |
Request body example
{
"sendDocumentsToEmail": "[email protected]",
"shipmentID": "the_shipment_id_to_return",
"itemsAnnounced": [
{
"amount": 1,
"reason": "arrived-too-late",
"shipmentItemID": "the_shipment_item_id_to_return"
}
],
}
Successful response example
{
"data": {
"courier": "colissimo_fr",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"userID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"status": "announced",
"reason": "customer",
"portalTier": "basic",
"createdAt": "2023-12-11T10:02:52.402Z",
"documents": [
{
"type": "string",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"createdAt": "2023-12-11T10:02:52.402Z",
"updatedAt": "2023-12-11T10:02:52.402Z",
"dataType": "string"
}
],
"updatedAt": "2023-12-11T10:02:52.402Z",
"documentsEmailLanguage": "st",
"itemsAnnounced": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"reason": "string",
"createdAt": "2023-12-11T10:02:52.402Z",
"updatedAt": "2023-12-11T10:02:52.402Z",
"amount": 1,
"shipmentItemID": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
],
"shipmentID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"returnType": "customer",
"sendDocumentsToEmail": "[email protected]"
}
}
Updated 8 days ago