Create parcel

post

http://api.shipper.aeropost.com/api/parcels

A parcel is a package that will be tendered to a end customer through Aeroposts network.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Create parcel. Maximum 2500 parcels per shipment

tracking_code

string

Required. Barcode used by the shipper - Max 20 characters

order_number

string

Required. Shipper order number - Max 20 characters

courier_id

integer

Required. Available courier IDs will be provided

country_code

string

enum

Required. ISO 3166-1 alpha-2 country code

ship_to

string

enum

Required. Available values are location_id and address. If location_id is chosen, address will be ignored and vise versa

Allowed:

location_id

string

Required if ship_to is location_id. Use Get Locations endpoint to get the id of a location.

identification_type

integer

For the purpose of clearing customs and delivery, a valid identity document reference is required. See Valid Identity document page.

identification_number

string

Identification number on the provided identification document

first_name

string

Required. First name of the receiver of the shipment - Max 40 characters

last_name

string

Required. Last name of the receiver of the shipment - Max 30 characters

string

Must be a valid email for the receiver of the shipment, max 50 characters

phone

string

Required. Valid mobile phone number (uses glib phone to validate)

address

string

Required if ship_to is address - Max 100 characters

address_extra

string

Max 100 characters

city

string

Required if ship_to is address - Max 30 characters

region

string

Required if ship_to is address - Max 30 characters

postal_code

string

Optional (not all countries use postal codes) - Max 15 characters

package_weight

string

Required. Decimal

package_weight_unit

string

enum

Required

Allowed:

delivery_instructions

string

Max 50 characters

delivery_route

integer

Max 3 digits

delivery_zen

integer

Max 4 digits

package_value_currency

string

enum

Required. Currency

items

array of objects

Required. Parcel items

items

invoice

string

Required. File, max 4 Megabytes

Responses

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

201Successful response

403Error response

422Error response