Skydropx Shipments API
Create, list, retrieve, cancel, and protect shipments.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/skydropx-shipments-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Skydropx Pro Shipments API
description: The Skydropx Pro API is a REST interface for the Skydropx multi-carrier shipping and logistics platform (Mexico and Latin America).
version: '1.0'
contact:
name: Skydropx
url: https://www.skydropx.com/
servers:
- url: https://pro.skydropx.com/api/v1
description: Skydropx Pro production
- url: https://sb-pro.skydropx.com/api/v1
description: Skydropx Pro sandbox
security:
- oauth2ClientCredentials: []
tags:
- name: Shipments
description: Create, list, retrieve, cancel, and protect shipments.
paths:
/shipments:
get:
operationId: listShipments
tags:
- Shipments
summary: List shipments
description: Lists shipments, optionally filtered by status and date range.
parameters:
- name: page
in: query
required: false
schema:
type: integer
- name: status
in: query
required: false
schema:
type: string
responses:
'200':
description: A page of shipments.
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Shipment'
'401':
$ref: '#/components/responses/Unauthorized'
post:
operationId: createShipment
tags:
- Shipments
summary: Create a shipment
description: Creates a shipment from a quotation and a selected rate, purchasing the label and debiting the prepaid account balance. Requires SAT consignment-note (Carta Porte) codes for applicable Mexican shipments.
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/ShipmentInput'
responses:
'201':
description: The created shipment.
content:
application/json:
schema:
$ref: '#/components/schemas/Shipment'
'401':
$ref: '#/components/responses/Unauthorized'
'422':
$ref: '#/components/responses/ValidationError'
/shipments/{id}:
parameters:
- $ref: '#/components/parameters/Id'
get:
operationId: getShipment
tags:
- Shipments
summary: Retrieve a shipment
description: Retrieves a shipment by id, including its label URL and tracking data.
responses:
'200':
description: The requested shipment.
content:
application/json:
schema:
$ref: '#/components/schemas/Shipment'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
/shipments/{id}/cancellations:
parameters:
- $ref: '#/components/parameters/Id'
post:
operationId: cancelShipment
tags:
- Shipments
summary: Cancel a shipment
description: Requests cancellation of a shipment and refund of the label where eligible.
responses:
'201':
description: The cancellation request.
content:
application/json:
schema:
type: object
additionalProperties: true
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
/shipments/{id}/protect:
parameters:
- $ref: '#/components/parameters/Id'
post:
operationId: protectShipment
tags:
- Shipments
summary: Add shipment protection
description: Adds optional parcel protection / insurance coverage to a shipment.
requestBody:
required: false
content:
application/json:
schema:
type: object
additionalProperties: true
responses:
'201':
description: The protected shipment.
content:
application/json:
schema:
$ref: '#/components/schemas/Shipment'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
components:
responses:
ValidationError:
description: The request payload failed validation.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Unauthorized:
description: Missing or invalid access token.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
NotFound:
description: The requested resource was not found.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
schemas:
ShipmentInput:
type: object
required:
- quotation_id
- rate_id
- address_from
- address_to
properties:
quotation_id:
type: string
rate_id:
type: string
address_from:
$ref: '#/components/schemas/Address'
address_to:
$ref: '#/components/schemas/Address'
parcels:
type: array
items:
$ref: '#/components/schemas/Parcel'
consignment_note_class_code:
type: string
description: SAT product classification code (Carta Porte).
consignment_note_packaging_code:
type: string
description: SAT packaging code (Carta Porte).
additionalProperties: true
Error:
type: object
properties:
message:
type: string
errors:
type: object
additionalProperties: true
Address:
type: object
description: A shipping address (origin, destination, or saved template).
properties:
id:
type: string
name:
type: string
company:
type: string
street1:
type: string
street2:
type: string
city:
type: string
province:
type: string
zip:
type: string
country:
type: string
description: ISO country code, e.g. MX.
phone:
type: string
email:
type: string
reference:
type: string
additionalProperties: true
Parcel:
type: object
description: Parcel dimensions and weight.
properties:
length:
type: number
description: Length in centimeters.
width:
type: number
description: Width in centimeters.
height:
type: number
description: Height in centimeters.
weight:
type: number
description: Weight in kilograms.
Rate:
type: object
properties:
id:
type: string
provider:
type: string
description: Carrier name, e.g. estafeta, fedex, dhl.
service_level:
type: string
total_pricing:
type: string
description: Total price for the service.
currency:
type: string
example: MXN
days:
type: integer
description: Estimated transit days.
additionalProperties: true
Shipment:
type: object
properties:
id:
type: string
status:
type: string
tracking_number:
type: string
label_url:
type: string
format: uri
rate:
$ref: '#/components/schemas/Rate'
address_from:
$ref: '#/components/schemas/Address'
address_to:
$ref: '#/components/schemas/Address'
created_at:
type: string
format: date-time
additionalProperties: true
parameters:
Id:
name: id
in: path
required: true
description: The unique identifier of the resource.
schema:
type: string
securitySchemes:
oauth2ClientCredentials:
type: oauth2
description: 'OAuth2 client-credentials flow. Exchange client_id and client_secret at POST /oauth/token for a Bearer access token, sent as `Authorization: Bearer ACCESS_TOKEN`. Tokens last about two hours.'
flows:
clientCredentials:
tokenUrl: https://pro.skydropx.com/api/v1/oauth/token
scopes: {}