Skydropx API
Welcome to the skydropx API! You can use our API to access skydropx API endpoints, which can get information about Shipments and Labels, also create Cancel Label Requests.
You can view code examples in the dark area to the right.
Skydropx CHANGELOG
13/04/2022
- Added order relationship attribute in 'Get all shipments' endpoint response.
- Added order relationship attribute in 'Get a specific shipment' endpoint response.
- Added order parameter (optional) in 'Create a shipment' endpoint.
28/04/2022
- Added effectiveness and ranking attributes in 'Get all shipments' endpoint response.
- Added effectiveness and ranking attributes in 'Get a specific shipment' endpoint response.
- Added carriers parameter (optional) in 'Create a shipment' endpoint.
- Added carriers parameter (optional) in 'Get a quotation' endpoint.
Authentication
Skydropx uses API keys to allow access to the API. You need to contact our support team to get your API key. [email protected]
Skydropx expects for the API key to be included in all API requests to the server in a header that looks like the following:
Authorization: Token token=YOUR_API_KEY
- 1
- 2
- 3
- 4
- # With shell, you can just pass the correct header with each request. \
- curl "https://api.skydropx.com/v1/shipments" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json"
Developer Testing
We recommend to use our demo environment before run your code in production.
- Firstly, you need to register in demo environment create account.
- Contact our support team to get your API key.
The URL for demo environment is:
https://api-demo.skydropx.com/
Carriers
Get a list of carriers
Returns the available carriers from the user account
HTTP Request
GET https://api.skydropx.com/v1/carriers
- 1
- 2
- 3
- curl "https://api.skydropx.com/v1/carriers" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json"
{
"data": [
{
"id": "785f39d0-11f7-4fcf-871e-5dad6795bbb7",
"type": "carrier",
"attributes": {
"name": "Fedex"
}
},
{
"id": "746c7235-7452-4a82-8ab7-5f3c36fc4680",
"type": "carrier",
"attributes": {
"name": "DHL"
}
}
]
}
Quotations
Get a Quotation
This endpoint receives zip codes and parcel measures. It returns a list that contains all Rates found.
HTTP Request
POST https://api.skydropx.com/v1/quotations
Parameters
- zip_fromString
Zip code of origin.
- zip_toString
Zip code of destination.
- parcelObject
Used to specify the measures and total Parcel weight.
- weightInteger
Weight of Parcel, must be in KG.
- heightInteger
Height of Parcel, must be in CM.
- widthInteger
Width of Parcel, must be in CM.
- lengthInteger
Length of Parcel, must be in CM.
- carriersArray (optional)
Quote with specific carriers
Description
The field amount_local
is used to indicate the price of the service. Depending on the zip code, they may have extra charges.
Out of area means that zone is not covered for normal delivery and generates extra charges.
out_of_area_service
is used to indicate if the service is out of the area for normal delivery and if it's true.
out_of_area_pricing
have the pricing for this extra service.
total_pricing
have the sum of amount_local
and out_of_area_pricing
.
days
Estimated time of arrival.
insurable
means that the shipment could be insured declaring a cost. Not implemented yet in this API version.
is_ocurre
is used to indicate if the shipment is to a home address or to a branch office.
- 1
- 2
- 3
- 4
- curl "https://api.skydropx.com/v1/quotations" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json" \
- -d '{ "zip_from": "02900", "zip_to": "44100", "parcel": { "weight": "1", "height": "10", "width": "10", "length": "10" }, "carriers": [{ "name": "DHL" }, { "name": "Fedex" }] }'
[
{
"amount_local": 540,
"currency_local": "MXN",
"provider": "UPS",
"service_level_name": "UPS Express",
"service_level_code": "EXPRESS_SAVER",
"days": 2,
"insurable": false,
"out_of_area_service": false,
"out_of_area_pricing": 0,
"total_pricing": 540,
"is_occure": true
},
{
"amount_local": 681,
"currency_local": "MXN",
"provider": "ESTAFETA",
"service_level_name": "Servicio Express",
"service_level_code": "ESTAFETA_NEXT_DAY",
"days": 2,
"insurable": true,
"out_of_area_service": true,
"out_of_area_pricing": 100,
"total_pricing": 781,
"is_occure": true
}
]
Shipments
Get All Shipments
This endpoint retrieves all Shipments.
HTTP Request
GET https://api.skydropx.com/v1/shipments
Query Parameters
- pageInteger, default is 1
Number of page.
- per_pageInteger, default is 20
Quantity of records per page.
- 1
- 2
- 3
- curl "https://api.skydropx.com/v1/shipments" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json"
{
"data": [
{
"id": "902675",
"type": "shipments",
"attributes": {
"status": "WAITING",
"created_at": "2018-12-18T15:00:21.892-06:00",
"updated_at": "2018-12-18T15:00:21.892-06:00"
},
"relationships": {
"parcel": {
"data": {
"id": "773773",
"type": "parcels"
}
},
"rates": {
"data": [
{
"id": "7146458",
"type": "rates"
},
{
"id": "7146457",
"type": "rates"
},
{
"id": "7146456",
"type": "rates"
},
{
"id": "7146455",
"type": "rates"
},
{
"id": "7146454",
"type": "rates"
}
]
},
"address_to": {
"data": {
"id": "2901622",
"type": "addresses"
}
},
"address_from": {
"data": {
"id": "2901621",
"type": "addresses"
}
},
"label": {
"data": null
}
}
}
],
"included": [
{
"id": "773773",
"type": "parcels",
"attributes": {
"length": "10.0",
"height": "10.0",
"width": "10.0",
"weight": "3.0",
"mass_unit": "KG",
"distance_unit": "CM"
}
},
{
"id": "7146458",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.418-06:00",
"updated_at": "2018-12-18T15:00:22.418-06:00",
"amount_local": "119.0",
"currency_local": "MXN",
"provider": "CARSSA",
"service_level_name": "Nacional",
"service_level_code": "NACIONAL",
"service_level_terms": null,
"days": 5,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": false,
"out_of_area_pricing": "0.0",
"total_pricing": "119.0",
"is_occure": true
}
},
{
"id": "7146457",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.389-06:00",
"updated_at": "2018-12-18T15:00:22.389-06:00",
"amount_local": "204.0",
"currency_local": "MXN",
"provider": "DHL",
"service_level_name": "DHL Express",
"service_level_code": "EXPRESS",
"service_level_terms": null,
"days": 2,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": true,
"out_of_area_pricing": "145.00",
"total_pricing": "349.0",
"is_occure": true
}
},
{
"id": "7146456",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.380-06:00",
"updated_at": "2018-12-18T15:00:22.380-06:00",
"amount_local": "180.0",
"currency_local": "MXN",
"provider": "DHL",
"service_level_name": "DHL Terrestre",
"service_level_code": "STANDARD",
"service_level_terms": null,
"days": 5,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": true,
"out_of_area_pricing": "145.00",
"total_pricing": "325.0",
"is_occure": true
}
},
{
"id": "7146455",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.150-06:00",
"updated_at": "2018-12-18T15:00:22.150-06:00",
"amount_local": "205.0",
"currency_local": "MXN",
"provider": "FEDEX",
"service_level_name": "Standard Overnight",
"service_level_code": "STANDARD_OVERNIGHT",
"service_level_terms": null,
"days": 2,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": true,
"out_of_area_pricing": "145.00",
"total_pricing": "350.0",
"is_occure": true
}
},
{
"id": "7146454",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.141-06:00",
"updated_at": "2018-12-18T15:00:22.141-06:00",
"amount_local": "149.0",
"currency_local": "MXN",
"provider": "FEDEX",
"service_level_name": "Fedex Express Saver",
"service_level_code": "FEDEX_EXPRESS_SAVER",
"service_level_terms": null,
"days": 5,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": true,
"out_of_area_pricing": "145.00",
"total_pricing": "294.0",
"is_occure": true
}
},
{
"id": "2901622",
"type": "addresses",
"attributes": {
"name": "Jorge Fernández",
"company": "-",
"address1": "Av. Lázaro Cárdenas #234",
"address2": "Americana",
"city": "Guadalajara",
"province": "Jalisco",
"zip": "23312",
"country": "MX",
"phone": "5555555555",
"email": "[email protected]",
"created_at": "2018-12-18T15:00:21.887-06:00",
"updated_at": "2018-12-18T15:00:21.887-06:00"
}
},
{
"id": "2901621",
"type": "addresses",
"attributes": {
"name": "Jose Fernando",
"company": "skydropx",
"address1": "Av. Principal #234",
"address2": "Centro",
"city": "Guadalajara",
"province": "Jalisco",
"zip": "02900",
"country": "MX",
"phone": "5555555555",
"email": "[email protected]",
"created_at": "2018-12-18T15:00:21.874-06:00",
"updated_at": "2018-12-18T15:00:21.874-06:00"
}
}
],
"links": {
"self": "https://api.skydropx.com/v1/shipments?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"first": "https://api.skydropx.com/v1/shipments?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"prev": null,
"next": null,
"last": "https://api.skydropx.com/v1/shipments?page%5Bnumber%5D=1&page%5Bsize%5D=20"
}
}
Get a Specific Shipment
This endpoint retrieves a specific Shipment.
HTTP Request
GET https://api.skydropx.com/v1/shipments/ID
URL Parameters
- IDInteger
The ID of the Shipment to retrieve.
- 1
- 2
- 3
- curl "GET https://api.skydropx.com/v1/shipments/<ID>" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json"
{
"data": {
"id": "902675",
"type": "shipments",
"attributes": {
"status": "WAITING",
"created_at": "2018-12-18T15:00:21.892-06:00",
"updated_at": "2018-12-18T15:00:21.892-06:00"
},
"relationships": {
"parcel": {
"data": {
"id": "773773",
"type": "parcels"
}
},
"rates": {
"data": [
{
"id": "7146458",
"type": "rates"
},
{
"id": "7146457",
"type": "rates"
},
{
"id": "7146456",
"type": "rates"
},
{
"id": "7146455",
"type": "rates"
},
{
"id": "7146454",
"type": "rates"
}
]
},
"address_to": {
"data": {
"id": "2901622",
"type": "addresses"
}
},
"address_from": {
"data": {
"id": "2901621",
"type": "addresses"
}
},
"label": {
"data": null
}
}
},
"included": [
{
"id": "773773",
"type": "parcels",
"attributes": {
"length": "10.0",
"height": "10.0",
"width": "10.0",
"weight": "3.0",
"mass_unit": "KG",
"distance_unit": "CM"
}
},
{
"id": "7146458",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.418-06:00",
"updated_at": "2018-12-18T15:00:22.418-06:00",
"amount_local": "119.0",
"currency_local": "MXN",
"provider": "CARSSA",
"service_level_name": "Nacional",
"service_level_code": "NACIONAL",
"service_level_terms": null,
"days": 5,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": false,
"out_of_area_pricing": "0.0",
"total_pricing": "119.0",
"is_occure": true
}
},
{
"id": "7146457",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.389-06:00",
"updated_at": "2018-12-18T15:00:22.389-06:00",
"amount_local": "204.0",
"currency_local": "MXN",
"provider": "DHL",
"service_level_name": "DHL Express",
"service_level_code": "EXPRESS",
"service_level_terms": null,
"days": 2,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": true,
"out_of_area_pricing": "145.00",
"total_pricing": "349.0",
"is_occure": true
}
},
{
"id": "7146456",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.380-06:00",
"updated_at": "2018-12-18T15:00:22.380-06:00",
"amount_local": "180.0",
"currency_local": "MXN",
"provider": "DHL",
"service_level_name": "DHL Terrestre",
"service_level_code": "STANDARD",
"service_level_terms": null,
"days": 5,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": true,
"out_of_area_pricing": "145.00",
"total_pricing": "325.0",
"is_occure": true
}
},
{
"id": "7146455",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.150-06:00",
"updated_at": "2018-12-18T15:00:22.150-06:00",
"amount_local": "205.0",
"currency_local": "MXN",
"provider": "FEDEX",
"service_level_name": "Standard Overnight",
"service_level_code": "STANDARD_OVERNIGHT",
"service_level_terms": null,
"days": 2,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": true,
"out_of_area_pricing": "145.00",
"total_pricing": "350.0",
"is_occure": true
}
},
{
"id": "7146454",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.141-06:00",
"updated_at": "2018-12-18T15:00:22.141-06:00",
"amount_local": "149.0",
"currency_local": "MXN",
"provider": "FEDEX",
"service_level_name": "Fedex Express Saver",
"service_level_code": "FEDEX_EXPRESS_SAVER",
"service_level_terms": null,
"days": 5,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": true,
"out_of_area_pricing": "145.00",
"total_pricing": "294.0",
"is_occure": true
}
},
{
"id": "2901622",
"type": "addresses",
"attributes": {
"name": "Jorge Fernández",
"company": "-",
"address1": "Av. Lázaro Cárdenas #234",
"address2": "Americana",
"city": "Guadalajara",
"province": "Jalisco",
"zip": "23312",
"country": "MX",
"phone": "5555555555",
"email": "[email protected]",
"created_at": "2018-12-18T15:00:21.887-06:00",
"updated_at": "2018-12-18T15:00:21.887-06:00"
}
},
{
"id": "2901621",
"type": "addresses",
"attributes": {
"name": "Jose Fernando",
"company": "skydropx",
"address1": "Av. Principal #234",
"address2": "Centro",
"city": "Guadalajara",
"province": "Jalisco",
"zip": "02900",
"country": "MX",
"phone": "5555555555",
"email": "[email protected]",
"created_at": "2018-12-18T15:00:21.874-06:00",
"updated_at": "2018-12-18T15:00:21.874-06:00"
}
}
]
}
Create a Shipment
This endpoint creates a Shipment.
HTTP Request
POST https://api.skydropx.com/v1/shipments
Description
The field contents
under address_to
object is used to indicate the description of package contents.
- 1
- 2
- 3
- 4
- curl "https://api.skydropx.com/v1/shipments" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json" \
- -d '{ "address_from": {"province": "Ciudad de México", "city": "Azcapotzalco", "name": "Jose Fernando", "zip": "02900", "country": "MX", "address1": "Av. Principal #234", "company": "skydropx", "address2": "Centro", "phone": "5555555555", "email": "[email protected]"}, "parcels": [{ "weight": 3, "distance_unit": "CM", "mass_unit": "KG", "height": 10, "width": 10, "length": 10 }], "address_to": { "province": "Jalisco", "city": "Guadalajara", "name": "Jorge Fernández", "zip": "44100", "country": "MX", "address1": " Av. Lázaro Cárdenas #234", "company": "-", "address2": "Americana", "phone": "5555555555", "email": "[email protected]", "reference": "Frente a tienda de abarro", "contents": "" }, "consignment_note_class_code": "53131600", "consignment_note_packaging_code": "1H1", "carriers": [{ "name": "DHL" }, { "name": "Fedex" }] }'
{
"data": {
"id": "902675",
"type": "shipments",
"attributes": {
"status": "WAITING",
"created_at": "2018-12-18T15:00:21.892-06:00",
"updated_at": "2018-12-18T15:00:21.892-06:00"
},
"relationships": {
"parcel": {
"data": {
"id": "773773",
"type": "parcels"
}
},
"rates": {
"data": [
{
"id": "7146454",
"type": "rates"
},
{
"id": "7146455",
"type": "rates"
},
{
"id": "7146456",
"type": "rates"
},
{
"id": "7146457",
"type": "rates"
},
{
"id": "7146458",
"type": "rates"
}
]
},
"address_to": {
"data": {
"id": "2901622",
"type": "addresses"
}
},
"address_from": {
"data": {
"id": "2901621",
"type": "addresses"
}
},
"label": {
"data": null
},
"consignment_note_class": {
"data": {
"id": 641,
"name": "Papel de imprenta y papel de escribir",
"code": "14111500",
"subcategory_id": 50,
"created_at": "2021-12-02T07:10:55.072-06:00",
"updated_at": "2021-12-02T07:10:55.072-06:00"
}
},
"consignment_note_packaging": {
"data": {
"id": 27,
"code": "Z01",
"name": "No aplica",
"created_at": "2022-02-03T12:28:03.388-06:00",
"updated_at": "2022-02-03T12:28:03.388-06:00"
}
}
}
},
"included": [
{
"id": "773773",
"type": "parcels",
"attributes": {
"length": "10.0",
"height": "10.0",
"width": "10.0",
"weight": "3.0",
"mass_unit": "KG",
"distance_unit": "CM"
}
},
{
"id": "7146454",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.141-06:00",
"updated_at": "2018-12-18T15:00:22.141-06:00",
"amount_local": "149.0",
"currency_local": "MXN",
"provider": "FEDEX",
"service_level_name": "Fedex Express Saver",
"service_level_code": "FEDEX_EXPRESS_SAVER",
"service_level_terms": null,
"days": 5,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": true,
"out_of_area_pricing": "145.00",
"total_pricing": "294.0",
"is_occure": true
}
},
{
"id": "7146455",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.150-06:00",
"updated_at": "2018-12-18T15:00:22.150-06:00",
"amount_local": "205.0",
"currency_local": "MXN",
"provider": "FEDEX",
"service_level_name": "Standard Overnight",
"service_level_code": "STANDARD_OVERNIGHT",
"service_level_terms": null,
"days": 2,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": true,
"out_of_area_pricing": "145.00",
"total_pricing": "350.0",
"is_occure": true
}
},
{
"id": "7146456",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.380-06:00",
"updated_at": "2018-12-18T15:00:22.380-06:00",
"amount_local": "180.0",
"currency_local": "MXN",
"provider": "DHL",
"service_level_name": "DHL Terrestre",
"service_level_code": "STANDARD",
"service_level_terms": null,
"days": 5,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": true,
"out_of_area_pricing": "145.00",
"total_pricing": "325.0",
"is_occure": true
}
},
{
"id": "7146457",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.389-06:00",
"updated_at": "2018-12-18T15:00:22.389-06:00",
"amount_local": "204.0",
"currency_local": "MXN",
"provider": "DHL",
"service_level_name": "DHL Express",
"service_level_code": "EXPRESS",
"service_level_terms": null,
"days": 2,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": true,
"out_of_area_pricing": "145.00",
"total_pricing": "349.0",
"is_occure": true
}
},
{
"id": "7146458",
"type": "rates",
"attributes": {
"created_at": "2018-12-18T15:00:22.418-06:00",
"updated_at": "2018-12-18T15:00:22.418-06:00",
"amount_local": "119.0",
"currency_local": "MXN",
"provider": "CARSSA",
"service_level_name": "Nacional",
"service_level_code": "NACIONAL",
"service_level_terms": null,
"days": 5,
"duration_terms": null,
"zone": null,
"arrives_by": null,
"out_of_area": false,
"out_of_area_pricing": "0.0",
"total_pricing": "119.0",
"is_occure": true
}
},
{
"id": "2901622",
"type": "addresses",
"attributes": {
"name": "Jorge Fernández",
"company": "-",
"address1": "Av. Lázaro Cárdenas #234",
"address2": "Americana",
"city": "Guadalajara",
"province": "Jalisco",
"zip": "23312",
"country": "MX",
"phone": "5555555555",
"email": "[email protected]",
"created_at": "2018-12-18T15:00:21.887-06:00",
"updated_at": "2018-12-18T15:00:21.887-06:00"
}
},
{
"id": "2901621",
"type": "addresses",
"attributes": {
"name": "Jose Fernando",
"company": "skydropx",
"address1": "Av. Principal #234",
"address2": "Centro",
"city": "Guadalajara",
"province": "Jalisco",
"zip": "02900",
"country": "MX",
"phone": "5555555555",
"email": "[email protected]",
"created_at": "2018-12-18T15:00:21.874-06:00",
"updated_at": "2018-12-18T15:00:21.874-06:00"
}
}
]
}
Labels
Get all labels
This endpoint retrieves all Labels.
HTTP Request
GET https://api.skydropx.com/v1/labels
Query Parameters
- pageInteger, default is 1
Number of page.
- per_pageInteger, default is 20
Quantity of records per page.
- 1
- 2
- 3
- curl "https://api.skydropx.com/v1/labels" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json"
{
"data": [
{
"id": "39",
"type": "labels",
"attributes": {
"created_at": "2018-07-26T00:18:56.665-05:00",
"updated_at": "2018-07-26T00:18:56.665-05:00",
"status": null,
"tracking_number": "XXXXXXXXXX",
"tracking_status": null,
"label_url": "label-url.pdf",
"tracking_url_provider": "http://www.estafeta.com/Rastreo/XXXXXXXXXX",
"rate_id": 3087
}
},
{
"id": "40",
"type": "labels",
"attributes": {
"created_at": "2018-07-26T00:18:57.326-05:00",
"updated_at": "2018-07-26T00:18:57.326-05:00",
"status": null,
"tracking_number": "XXXXXXXXXX",
"tracking_status": null,
"label_url": "label-url.pdf",
"tracking_url_provider": "http://www.estafeta.com/Rastreo/XXXXXXXXXX",
"rate_id": 3089
}
}
],
"links": {
"self": "https://api.skydropx.com/v1/labels?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"first": "https://api.skydropx.com/v1/labels?page%5Bnumber%5D=1&page%5Bsize%5D=20",
"prev": null,
"next": "https://api.skydropx.com/v1/labels?page%5Bnumber%5D=2&page%5Bsize%5D=20",
"last": "https://api.skydropx.com/v1/labels?page%5Bnumber%5D=13&page%5Bsize%5D=20"
}
}
Get a Specific Label
This endpoint retrieves a specific Label.
HTTP Request
GET https://api.skydropx.com/v1/labels/ID
URL Parameters
- ID
The ID of the Label to retrieve.
- 1
- 2
- 3
- curl "GET https://api.skydropx.com/v1/labels/<ID>" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json"
{
"data": {
"id": "2",
"type": "labels",
"attributes": {
"created_at": "2018-07-18T16:05:05.370-05:00",
"updated_at": "2018-07-18T16:05:05.370-05:00",
"status": null,
"tracking_number": "XXXXXXXXXX",
"tracking_status": null,
"label_url": "label-url.pdf",
"tracking_url_provider": "https://www.fedex.com/apps/fedextrack/?action=track&trackingnumber=XXXXXXXXXX",
"rate_id": 3
}
}
}
Create a label
This endpoint creates a Label.
HTTP Request
POST https://api.skydropx.com/v1/labels
- 1
- 2
- 3
- 4
- curl "https://api.skydropx.com/v1/labels" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json" \
- -d '{ "rate_id": 10834, "label_format": "pdf" }'
{
"data": {
"id": "414",
"type": "labels",
"attributes": {
"created_at": "2018-09-04T16:32:49.190-05:00",
"updated_at": "2018-09-04T16:32:49.190-05:00",
"status": null,
"tracking_number": "XXXXXXXXXX",
"tracking_status": null,
"label_url": "label-url.pdf",
"tracking_url_provider": "https://www.grupocarssa.com/new/XXXXXXXXXX",
"rate_id": 11931
}
}
}
Cancel Label Request
Create a Cancel Label Request
This endpoint creates a Cancel Label Request.
HTTP Request
POST https://api.skydropx.com/v1/cancel_label_requests
- 1
- 2
- 3
- 4
- curl "https://api.skydropx.com/v1/cancel_label_requests" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json" \
- -d '{ "tracking_number": XXXXXXXXXX, "reason": "Datos de dirección erróneos." }'
{
"data": {
"id": "18",
"type": "cancel_requests",
"attributes": {
"status": "reviewing",
"reason": "Datos de dirección erróneos.",
"created_at": "2018-09-05T09:24:35.453-05:00",
"updated_at": "2018-09-05T09:24:35.453-05:00"
}
}
}
Get All Cancel Label Request
This endpoint retrieves all Cancel Label Requests.
HTTP Request
GET https://api.skydropx.com/v1/cancel_label_requests
Query Parameters
- statusString
Status
status="reviewing|rejected|approved"
. - dateString
Date
date="2020-11-13"
.
- 1
- 2
- 3
- curl "https://api.skydropx.com/v1/cancel_request?status=reviewing|rejected" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json"
{
"data": {
"cancel_requests_pending": 2,
"cancel_requests": [
{
"id": 21,
"status": "rejected",
"reason": "Paquetería o servicio erróneo.",
"messages": "no valido",
"shipment_id": 235,
"created_at": "2020-11-13T12:38:34.412-06:00",
"updated_at": "2020-11-13T17:10:12.673-06:00",
"user_id": 1,
"headquarter_id": 1
},
{
"id": 20,
"status": "reviewing",
"reason": "Datos de dirección erróneos.",
"messages": null,
"shipment_id": 236,
"created_at": "2020-11-13T12:38:28.113-06:00",
"updated_at": "2020-11-13T12:38:28.113-06:00",
"user_id": 1,
"headquarter_id": 1
}
]
}
}
Bulk Labels
This endpoint sends by email the specified labels in a single pdf file.
HTTP Request
GET https://api.skydropx.com/v1/bulk_labels
URL Parameters
- emailsString
Recipient emails separated by commas
- label_idsString
Labels identifiers separated by commas
- 1
- 2
- 3
- curl "https://api.skydropx.com/v1/[email protected],[email protected]&label_ids=1,2,3" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json"
Consignment Note Categories
Index of categories of products established by SAT and demanded for the consignment note
HTTP Request
GET https://api.skydropx.com/v1/consignment_notes/categories
- 1
- 2
- 3
- curl "https://api.skydropx.com/v1/consignment_notes/categories" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json"
{
"data": [
{
"id": "1",
"type": "category",
"attributes": {
"name": "Material Vivo Vegetal y Animal, Accesorios y Suministros"
}
},
{
"id": "2",
"type": "category",
"attributes": {
"name": "Material Químico incluyendo Bioquímicos y Materiales de Gas"
}
},
{
"id": "3",
"type": "category",
"attributes": {
"name": "Material Mineral, Textil y Vegetal y Animal No Comestible"
}
},
{
"id": "4",
"type": "category",
"attributes": {
"name": "Materiales de Resina, Colofonia, Caucho, Espuma, Película y Elastómericos"
}
},
{
"id": "5",
"type": "category",
"attributes": {
"name": "Materiales y Productos de Papel"
}
}
]
}
Consignment Note Subcategories
Index of subcategories of products established by SAT and demanded for the consignment note filter by Category
HTTP Request
GET https://api.skydropx.com/v1/consignment_notes/categories/CATEGORY_ID/subcategories
- 1
- 2
- 3
- curl "https://api.skydropx.com/v1/consignment_notes/categories/<CATEGORY_ID>/subcategories" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json"
{
"data": [
{
"id": "49",
"type": "subcategory",
"attributes": {
"name": "Materiales de papel"
}
},
{
"id": "50",
"type": "subcategory",
"attributes": {
"name": "Productos de papel"
}
},
{
"id": "51",
"type": "subcategory",
"attributes": {
"name": "Papel para uso industrial"
}
}
]
}
Consignment Note Classes
Index of classes of products established by SAT and demanded for the consignment note filter by Subcategory. The code attribute is needed to create a shipment.
HTTP Request
GET https://api.skydropx.com/v1/consignment_notes/subcategories/SUBCATEGORY_ID/classes
- 1
- 2
- 3
- curl "https://api.skydropx.com/v1/consignment_notes/subcategories/<SUBCATEGORY_ID>/classes" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json"
{
"data": [
{
"id": "641",
"type": "class",
"attributes": {
"name": "Papel de imprenta y papel de escribir",
"code": "14111500"
}
},
{
"id": "642",
"type": "class",
"attributes": {
"name": "Papel fantasía",
"code": "14111600"
}
},
{
"id": "643",
"type": "class",
"attributes": {
"name": "Productos de papel para uso personal",
"code": "14111700"
}
},
{
"id": "644",
"type": "class",
"attributes": {
"name": "Papeles de uso comercial",
"code": "14111800"
}
}
]
}
Consignment Note Packagings
Index of packagings established by SAT and demanded for the consignment note. The code attribute is needed to create a shipment.
HTTP Request
GET https://api.skydropx.com/v1/consignment_notes/packagings
- 1
- 2
- 3
- curl "https://api.skydropx.com/v1/consignment_notes/packagings" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json"
[
{
"id": "1",
"type": "packagings",
"attributes": {
"name": "Bidones (Tambores) de Plástico de tapa no desmontable",
"code": "1H1"
}
},
{
"id": "2",
"type": "packagings",
"attributes": {
"name": "Bidones (Tambores) de Plástico de tapa desmontable",
"code": "1H2"
}
},
{
"id": "3",
"type": "packagings",
"attributes": {
"name": "Cajas de Aluminio",
"code": "4B"
}
}
]
Errors
The skydropx API uses the following error codes:
- 400Bad Request
Your request is invalid.
- 401Unauthorized
Your API key is wrong.
- 404Not Found
The specified resource could not be found.
- 500Internal Server Error
We had a problem with our server. Try again later.
Radar API
Welcome to the radar API! You can use our API to access radar API endpoints, which can get information about Shipments, also tracking shipments. You can view code examples in the dark area to the right.
Radar CHANGELOG
06/04/2022
- Added reference_number parameter (optional) in 'Get all shipments' endpoint.
- Added reference_number attribute in 'Get all shipments' endpoint response.
- Added reference_number attribute in 'Get a specific shipment' endpoint response.
- Added reference_number parameter (optional) in 'Create a shipment' endpoint.
Radar Authentication
Radar uses API keys to allow access to the API. You need to contact our support team to get your API key. [email protected]
Skydropx expects for the API key to be included in all API requests to the server in a header that looks like the following:
Authorization: Token token=YOUR_RADAR_API_KEY
- 1
- 2
- 3
- 4
- # With shell, you can just pass the correct header with each request. \
- curl "https://radar-api.skydropx.com/v1/shipments" \
- -H "Authorization: Token token=YOUR_API_KEY" \
- -H "Content-Type: application/json"
Radar Shipments
Radar Get all shipments
This endpoint retrieves all Shipments.
HTTP Request
GET https://radar-api.skydropx.com/v1/shipments
Query Parameters
- pageInteger, default is 1
Number of page.
- per_pageInteger, default is 25
Quantity of records per page.
- statusString
CREATED
The shipment is created, but have not yet been picked up by carrier.PICKED_UP
The shipment is out for delivery.IN_TRANSIT
The shipment is out for delivery.LAST_MILE
The shipment is out for delivery.DELIVERED
The shipment was delivered successfully.EXCEPTION
The shipment has any exception, it is likely presents some inconveniences such as returned or not delivered. - orderString, default is descending
ascending
Order shipments by created_at.
- 1
- 2
- 3
- curl "https://radar-api.skydropx.com/v1/shipments" \
- -H "Authorization: Token token=YOUR_RADAR_API_KEY" \
- -H "Content-Type: application/json"
{
"shipments": [
{
"id": "GXZahxtx2Pyu3Zs111111BBr",
"type": "Shipment",
"tracking_number": "1234",
"processed": true,
"status": "IN_TRANSIT",
"carrier": "FEDEX",
"carrier_service": "FEDEX_EXPRESS_SERVICE",
"tracking_url": "https://www.fedex.com/apps/fedextrack/?action=track&trackingnumber=1234",
"addresses": {
"address_from": {
"name": "SKYDROPX",
"street1": "Padre Raymundo Jardon 925",
"street2": "Centro",
"zipcode": "64000",
"city": "Monterrey",
"province": "NL",
"country": "MX",
"phone": "+525555555555",
"email": "[email protected]"
},
"address_to": {
"name": "SKYDROPX",
"street1": "Padre Raymundo Jardon 925",
"street2": "Centro",
"zipcode": "64000",
"city": "Monterrey",
"province": "NL",
"country": "MX",
"phone": "+525555555555",
"email": "[email protected]"
}
},
"created_at": "2020-03-11T16:49:23-06:00"
},
{
"id": "GXZahxtx2Pyu3Zs111111BBr",
"type": "Shipment",
"tracking_number": "4321",
"processed": true,
"status": "IN_TRANSIT",
"carrier": "FEDEX",
"carrier_service": "FEDEX_EXPRESS_SERVICE",
"tracking_url": "https://www.fedex.com/apps/fedextrack/?action=track&trackingnumber=4321",
"addresses": {
"address_from": {
"name": "SKYDROPX",
"street1": "Padre Raymundo Jardon 925",
"street2": "Centro",
"zipcode": "64000",
"city": "Monterrey",
"province": "NL",
"country": "MX",
"phone": "+525555555555",
"email": "[email protected]"
},
"address_to": {
"name": "SKYDROPX",
"street1": "Padre Raymundo Jardon 925",
"street2": "Centro",
"zipcode": "64000",
"city": "Monterrey",
"province": "NL",
"country": "MX",
"phone": "+525555555555",
"email": "[email protected]"
}
},
"created_at": "2020-03-11T16:49:23-06:00"
}
],
"meta": {
"current_page": "1",
"next_page": null,
"prev_page": null,
"total_count": "2",
"total_pages": "1"
}
}
Radar Get a specific Shipment
This endpoint retrieves a specific Shipment.
HTTP Request
GET https://radar-api.skydropx.com/v1/shipments/ID
URL Parameters
- ID
The ID of the Shipment to retrieve.
- 1
- 2
- 3
- curl "https://radar-api.skydropx.com/v1/shipments/<ID>" \
- -H "Authorization: Token token=YOUR_RADAR_API_KEY" \
- -H "Content-Type: application/json"
{
"shipment": {
"id": "GXZahxtx2Pyu3Zs111111BBr",
"type": "Shipment",
"tracking_number": "1234",
"processed": true,
"status": "IN_TRANSIT",
"carrier": "FEDEX",
"carrier_service": "FEDEX_EXPRESS_SERVICE",
"tracking_url": "https://www.fedex.com/apps/fedextrack/?action=track&trackingnumber=1234",
"addresses": {
"address_from": {
"name": "SKYDROPX",
"street1": "Padre Raymundo Jardon 925",
"street2": "Centro",
"zipcode": "64000",
"city": "Monterrey",
"province": "NL",
"country": "MX",
"phone": "+525555555555",
"email": "[email protected]"
},
"address_to": {
"name": "SKYDROPX",
"street1": "Padre Raymundo Jardon 925",
"street2": "Centro",
"zipcode": "64000",
"city": "Monterrey",
"province": "NL",
"country": "MX",
"phone": "+525555555555",
"email": "[email protected]"
}
},
"created_at": "2020-03-11T16:49:23-06:00"
}
}
Radar Create a Shipment
This endpoint records a shipment to be tracked on the Radar.
HTTP Request
POST https://radar-api.skydropx.com/v1/shipments
Parameters
- carrierrequired
Shipping carrier.
- tracking_numberrequired
Shipping tracking number.
- carrier_service
Shipping carrier service.
- address_to[name]required
Name of who will receive the shipment.
- address_to[phone]required
Mobile phone of who will receive the shipment.
- address_to[email]required
Email of who will receive the shipment.
- address_to[street1]
Delivery address.
- address_to[street2]
Delivery address.
- address_to[zip_code]
Delivery zip code.
- address_to[city]
Delivery city.
- address_to[province]
State of delivery.
- address_to[county]
Country of delivery.
- address_from[street1]
Shipping address.
- address_from[street2]
Shipping address.
- address_from[zip_code]
Shipping zip code.
- address_from[city]
Shipping city.
- address_from[province]
State of shipping.
- address_from[county]
Country of shipping.
- 1
- 2
- 3
- 4
- curl "https://radar-api.skydropx.com/v1/shipments/<ID>" \
- -H "Authorization: Token token=YOUR_RADAR_API_KEY" \
- -H "Content-Type: application/json" \
- -d '{ "shipment": { "carrier": "FEDEX", "tracking_number": "123456789", "carrier_service": "FEDEX_EXPRESS_SAVER", "address_to": { "name": "SKYDROPX", "street1": "Padre Raymundo Jardon 925", "street2": "Centro", "zipcode": "64000", "city": "Monterrey", "province": "Nuevo Leon", "country": "Mexico", "phone": "+525544383888", "email": "[email protected]" }, "address_from": { "province": "Jalisco", "city": "Guadalajara", "zip": "44100", "country": "MX", "street1": " Av. Lázaro Cárdenas #234", "street2": "Americana" }}}'
{
"shipment": {
"id": "GXZahxtx2Pyu3Zs111111BBr",
"type": "Shipment",
"tracking_number": "1234",
"processed": true,
"status": "IN_TRANSIT",
"carrier": "FEDEX",
"carrier_service": "FEDEX_EXPRESS_SERVICE",
"tracking_url": "https://www.fedex.com/apps/fedextrack/?action=track&trackingnumber=1234",
"addresses": {
"address_from": {
"name": "SKYDROPX",
"street1": "Padre Raymundo Jardon 925",
"street2": "Centro",
"zipcode": "64000",
"city": "Monterrey",
"province": "NL",
"country": "MX",
"phone": "+525555555555",
"email": "[email protected]"
},
"address_to": {
"name": "SKYDROPX",
"street1": "Padre Raymundo Jardon 925",
"street2": "Centro",
"zipcode": "64000",
"city": "Monterrey",
"province": "NL",
"country": "MX",
"phone": "+525555555555",
"email": "[email protected]"
}
},
"created_at": "2020-03-11T16:49:23-06:00"
}
}
Radar Tracking Shipments
Sending correct shipments keys
This endpoint returns an tracking shipments.
HTTP Request
POST https://radar-api.skydropx.com/v1/tracking
- 1
- 2
- 3
- 4
- curl "POST https://radar-api.skydropx.com/v1/tracking" \
- -H "Authorization: Token token=YOUR_RADAR_API_KEY" \
- -H "Content-Type: application/json" \
- -d '{ "tracking_numbers": [{ "carrier": "DHL", "tracking_number": "11111111" }, { "carrier": "FEDEX", "tracking_number": "987654321" }]}'
{
"data": {
"type": "tracking",
"trackings": [
{
"id": "GXZahxtx2Puu3ZsAAAAAABBr",
"type": "Shipment",
"tracking_number": "11111111",
"processed": true,
"status": "IN_TRANSIT",
"events": [
{
"status": "PICKED_UP",
"date": "2020-02-20T17:54:39-06:00",
"description": "Package received after cutoff",
"location": "Monterrey, NL"
}
],
"carrier": "DHL",
"carrier_service": "EXPRESS_SERVICE",
"created_at": "2020-03-11T16:49:23-06:00"
},
{
"id": "GXZahxtx2Pyu3Zs111111BBr",
"type": "Shipment",
"tracking_number": "987654321",
"processed": true,
"status": "IN_TRANSIT",
"events": [
{
"status": "PICKED_UP",
"date": "2020-02-20T17:54:39-06:00",
"description": "Package received after FedEx cutoff",
"location": "Monterrey, NL"
},
{
"status": "PICKED_UP",
"date": "2020-03-09T17:55:00-06:00",
"description": "EXPRESS",
"location": "Mexico, DF"
}
],
"carrier": "FEDEX",
"carrier_service": "FEDEX_EXPRESS_SERVICE",
"created_at": "2020-03-11T16:49:23-06:00"
}
]
}
}
Sending wrong shipment keys
This endpoint returns an tracking shipments.
HTTP Request
POST https://radar-api.skydropx.com/v1/tracking
- 1
- 2
- 3
- 4
- curl "POST https://radar-api.skydropx.com/v1/tracking" \
- -H "Authorization: Token token=YOUR_RADAR_API_KEY" \
- -H "Content-Type: application/json" \
- -d '{ "tracking_numbers": [{ "carrier": "DHL", "tracking_number": "11111111" }, { "carrier": "FEDEX", "tracking_number": "987654321" }]}'
{
"data": {
"type": "tracking",
"trackings": [
{
"carrier": "DHL",
"tracking_number": null,
"error": "Required key is missing"
},
{
"id": "GXZahxtx2Pyu3Zs111111BBr",
"type": "Shipment",
"tracking_number": "987654321",
"processed": true,
"status": "IN_TRANSIT",
"events": [
{
"status": "PICKED_UP",
"date": "2020-02-20T17:54:39-06:00",
"description": "Package received after FedEx cutoff",
"location": "Monterrey, NL"
}
],
"carrier": "FEDEX",
"carrier_service": "FEDEX_EXPRESS_SERVICE",
"created_at": "2020-03-11T16:49:23-06:00"
}
]
}
}
Tracking errors
Exceeding tracking limit
You can track up to 10 shipments per request and multiples carriers in the same request. If tracking numbers limit is execeed, the response will be:
{ "error": "Tracking numbers limit exceeded" }
Sending wrong request
If the request body is not as expected by Radar Tracking API, the response will be:
{ "error": "Request error" }
Radar Webhook
Shipment status change notifications webhook
You need to implement an HTTP POST endpoint that receives a JSON body and responds an HTTP STATUS 200 (OK) or 201 (CREATED).
Request
This is a JSON body example:
{ "type": "shipment", "action": "SHIPMENT_UPDATED", "timestamp": "2022-03-25T16:00:00Z", "data": { "id": "s5QaVWkPNheS6rW4bW9d2gfV", "carrier": "REDPACK", "status": "DELIVERED", "tracking_number": "070634535" } }
Attributes
The timestamp attribute is in UTC with ISO 8601 format.
The id attribute (data) is the same that can be used in https://docs.skydropx.com/#radar-get-a-specific-shipment endpoint.
The possible values for the status attribute (data) are: CREATED PICKED_UP IN_TRANSIT LAST_MILE DELIVERY_ATTEMPT DELIVERED CANCELED EXCEPTION PENDING.