CBT - Return Address#

How to get my access token?#

To generate your access token, follow the steps shown in how to get my access token

Request Format#

The request should have the following format:

bashCopy
1curl -X GET 'https://api.mercadolibre.com/shipments/{shipment_id}/seller/return_address' \\n  -H 'Authorization: Bearer {accessToken}'

Response Format#

A body with the seller's return address information is expected.

Status Codes#

Status	HTTP Code	Description
SUCCESS	200	Returns a response with the address information.
FAILED	4XX	It is expected to return "error" along with the "message" that describes the reason for the error.
ERROR	500	Any server error

Examples#

Request:#

bashCopy
1curl -X GET 'https://api.mercadolibre.com/shipments/123456789/seller/return_address' \\n  -H 'Authorization: Bearer xxxxxxxxx'

Response:#

Successful (200 OK)#

jsonCopy
1{
2    "address_line": "广东省中山市三角镇金三大道西1号金利达宝大仓",
3    "zip_code": "12345",
4    "phone": "132457680",
5    "additional_info": null,
6    "city": {
7        "id": "Q04tR0RaaG9uZ3NoYW4",
8        "name": "Zhongshan"
9    },
10    "state": {
11        "id": "CN-GD",
12        "name": "Guangdong"
13    },
14    "country": {
15        "id": "CN",
16        "name": "China"
17    }
18}

Note: address fields may contain non-ASCII characters (e.g., Chinese). Ensure your system handles UTF-8 encoding and applies NFC normalization.

Failed (Error HTTP 4XX)#

jsonCopy
1{
2    "error": "shipment_not_found",
3    "message": "Shipment not found",
4    "status": 404
5}

jsonCopy
1{
2    "error": "dispatch_info_not_found",
3    "message": "Dispatch info not found",
4    "status": 404
5}

jsonCopy
1{
2    "error": "shipment_bad_request",
3    "message": "the address is not available for shipping provided",
4    "status": 400
5}

Error (Error HTTP 5XX)#

jsonCopy
1{
2    "error": "internal_error",
3    "message": "Internal Server Error",
4    "status": 500
5}