Skip to Content

Developer / API Learning Center

Integrate shipping, tracking, labels, and rate quotes into your platform.

New Account Explore Our Services

Getting Started

This guide walks you through the fastest path to a working integration: generate API keys, send your first request, and (optionally) configure webhooks for real-time events.

Quick note: If you’re migrating from a legacy XML/EDI integration, you can still use those endpoints. For new builds, we recommend starting with API keys + webhooks for a cleaner integration.

1) Generate API keys

API keys are generated from your account portal in the API Access & Activity page. You can copy keys when needed and regenerate them if you’re rotating credentials.

API Access & Activity page showing API keys and recent activity

  • If you don’t have keys yet, click Request API Keys to generate them.
  • Once generated, you’ll see your Production key (and a Test key if available) listed on this page.
  • Store keys securely (password manager / secrets vault / environment variables).

2) Authentication

For SmartShip API endpoints, authentication is handled by passing your API key in the request URL as a query string parameter named key.

Keep your API key server-side whenever possible. Do not expose it in public-facing pages or client-side JavaScript.

Example

GET https://www.jetdelivery.com/api/v1/utilities/track/?idx=2345678&key=YOUR_API_KEY
Some endpoints work without a key, but including your key unlocks account-specific behavior:
  • Quotes: without a key you’ll see standard/list rates; with a key you’ll receive your negotiated account rates.
  • Tracking: without a key we may hide precise pickup/delivery details for privacy (for example, using the center of the ZIP code). With a key, authorized users can see more accurate shipment details.
Heads up: We monitor for unusual usage (for example, tracking multiple customers’ shipments from the same IP). If requests appear unauthorized, your access may be temporarily blocked for security. If that happens, contact us and we’ll help you get unblocked (often by approving your IP for testing).

3) Send your first request

Start with a quote request (fastest to validate authentication + connectivity), then move to shipment creation and tracking. 

curl "https://www.jetdelivery.com/api/v1/utilities/quote/?origin=90021&destination=92050&weight=50&key=YOUR_API_KEY"
Tip: Start with a quote request to confirm connectivity. Once that works, move on to creating shipments, tracking, and (optionally) webhooks for real-time updates.

4) Set up webhooks (recommended)

Webhooks allow Jet Delivery to send shipment events to your system in real time (pickup, delivery, dispatch updates, etc.). This keeps your platform up to date without polling our tracking endpoint.

  • Create an HTTPS endpoint in your system to receive events.
  • Configure your webhook URL and selected event types in your account portal.
  • Return a 200 response quickly; process events asynchronously when possible.

Troubleshooting

  • 401/403: Missing or invalid key, or the key does not have access to that endpoint.
  • 400: Request validation failed (missing required fields or invalid values).
  • No webhook deliveries: Endpoint unreachable, non-200 responses, or events not selected.
  • Blocked: Unusual testing patterns (for example, tracking multiple unrelated shipments). Contact support to unblock or approve your IP.