Trace

Use case

Package tracking API for Marketplaces

Marketplaces aggregate orders from many sellers and carriers, so you often need to look up hundreds of tracking numbers at once. Doing that one request at a time is slow and wasteful.

Trace's /v1/track/batch endpoint accepts up to 20 tracking numbers per request and returns each result in order, so you can fan out lookups efficiently.

How it works

  1. 1Collect tracking numbers from your marketplace orders.
  2. 2Send them to /v1/track/batch in groups of up to 20.
  3. 3Map each result back to its order and surface any errors for retry.

Node.js — batch-track marketplace orders

const response = await fetch("https://api.traceapi.dev/v1/track/batch", {
  method: "POST",
  headers: {
    Authorization: "Bearer " + process.env.TRACE_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    tracking_numbers: ["1Z999AA10123456784", "YT2213421266060000", "LP00012345678901"],
  }),
});

const results = await response.json();
for (const result of results) {
  console.log(result.tracking_number, result.status || result.error);
}

Marketplaces FAQ

How many tracking numbers can I batch?

Up to 20 per request. Each number counts as one lookup toward your plan.

Does batch preserve order?

Yes — results are returned in the same order as the submitted tracking numbers.

What happens if one number fails?

Each item returns its own result or error, so a single failure doesn't block the rest of the batch.

Start tracking for free.

Create an account, generate an API key, and track your first package in under two minutes — no credit card required.

Get your free API keyAll use cases