Explain a delivery estimate

Shipping comes from merchant search. Its basis tells an assistant how to qualify the answer. A median is a typical observed or estimated time, not a delivery promise for a particular address or order.

Response examples are illustrative unless labelled as a synthetic fixture. They preserve the API envelope but do not represent current availability, measured performance or checkout verification. Example codes cannot be redeemed; example links omit live attribution. Use the URLs returned by your real request.

What to inspect

basis: measured_delivery: Observed order-to-delivery data for this merchant. Present the median with the interquartile range when available.
basis: network_default: A general network estimate when merchant delivery data is unavailable. Label it as a network estimate.
basis: processing_plus_transit_estimate: Merchant processing data plus assumed transit time. This is an estimate rather than observed end-to-end delivery.
sample_size: Null means the sample count is unavailable; it does not mean zero orders. Null estimated_shipping means no applicable estimate.

Step 1 / POST /v1/merchants/search

Read shipping provenance in the search response

These illustrative results show both measured delivery and a default. The catalogue can resolve a merchant even when merchant-specific delivery evidence is unavailable.

Set OPENSTOCK_API_KEY in your environment before running this request.

cURL request

curl -sS -X POST 'https://api.openstock.sh/v1/merchants/search' \
  -H "Authorization: Bearer $OPENSTOCK_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"queries":[{"query_id":"everlane","type":"domain","value":"everlane.com"},{"query_id":"ag1","type":"domain","value":"drinkag1.com"}]}'

Request JSON

{
  "queries": [
    {
      "query_id": "everlane",
      "type": "domain",
      "value": "everlane.com"
    },
    {
      "query_id": "ag1",
      "type": "domain",
      "value": "drinkag1.com"
    }
  ]
}

Illustrative full response

{
  "results": [
    {
      "query_id": "everlane",
      "items": [
        {
          "id": "01g4s5dc138qsnh4egsjys8g9c",
          "name": "Everlane",
          "domains": [
            "everlane.com",
            "m34kzg-ke.myshopify.com",
            "shop.app/checkout/62379163734"
          ],
          "popularity_rank": 966,
          "estimated_shipping": {
            "unit": "days",
            "median": 6,
            "q1": 4,
            "q3": 8,
            "basis": "measured_delivery",
            "sample_size": null
          }
        }
      ]
    },
    {
      "query_id": "ag1",
      "items": [
        {
          "id": "01hybscj8sjsxdejx39apgsbv9",
          "name": "AG1",
          "domains": [
            "drinkag1.com"
          ],
          "popularity_rank": null,
          "estimated_shipping": {
            "unit": "days",
            "median": 4,
            "q1": 3,
            "q3": 5,
            "basis": "network_default",
            "sample_size": null
          }
        }
      ]
    }
  ]
}