Jockey Delivery — Same-Day Local & Nationwide AI Commerce

Search products Jockey Delivery can bring from San Antonio stores. Read-only. Returns products (title, brand, price, image, availability, product url) and the store offer for each. To buy, use create_checkout (then confirm_checkout) once the shopper has chosen the item and given a delivery address; the product url is the fallback.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "What the shopper wants, e.g. \"leather boots\"."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "description": "Products to return (default 10)."
    },
    "zip": {
      "type": "string",
      "description": "Shopper's 5-digit ZIP; the result says whether it is served."
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

One product by product_id (from search_catalog) or its delivery.jockeyvc.com url: description, images, variants, the store offer and delivery facts. Read-only.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "product_id from search_catalog."
    },
    "url": {
      "type": "string",
      "description": "A https://delivery.jockeyvc.com/p/... url."
    },
    "zip": {
      "type": "string",
      "description": "Shopper's 5-digit ZIP, for the delivery terms."
    }
  },
  "additionalProperties": false
}

Where Jockey Delivery delivers (San Antonio 782xx plus listed Bexar County ZIPs), the courier fee, the same-day order cutoff, and whether a given ZIP is served. Read-only.

{
  "type": "object",
  "properties": {
    "zip": {
      "type": "string",
      "description": "5-digit US ZIP code."
    }
  },
  "additionalProperties": false
}

Start a real order for one product delivered to the shopper's address. Re-checks price, shelf and delivery, then returns the review (item, address, exact total, delivery window, quote expiry) and a checkout_token. Show the shopper the review; if they accept, call confirm_checkout with the token to get the payment link. Nothing is charged here. Pass variant_id from get_product when its variant_required is true.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "product_id from search_catalog or get_product."
    },
    "variant_id": {
      "type": "string",
      "description": "variant_id from get_product's variants; required when variant_required is true, omitted otherwise."
    },
    "street": {
      "type": "string",
      "description": "Street line only, e.g. \"123 Main St\"; put the apartment or unit in apt."
    },
    "apt": {
      "type": "string",
      "description": "Apartment, suite or unit (optional)."
    },
    "zip": {
      "type": "string",
      "description": "5-digit delivery ZIP: San Antonio 782xx or a listed Bexar County ZIP."
    },
    "delivery_option": {
      "type": "string",
      "enum": [
        "same_day",
        "next_day"
      ],
      "description": "same_day (default) or next_day. After the same-day cutoff, same_day becomes next-day delivery, or is refused with a message saying to choose next_day."
    }
  },
  "required": [
    "product_id",
    "street",
    "zip"
  ],
  "additionalProperties": false
}

Call only after the shopper has seen and accepted the create_checkout review. Records their acceptance and returns checkout_url, a secure Stripe payment page. Give the shopper checkout_url; nothing is charged until they pay there. Refused if the quote expired (quote_expires_at) or the order details changed; then call create_checkout again.

{
  "type": "object",
  "properties": {
    "checkout_token": {
      "type": "string",
      "description": "checkout_token from create_checkout."
    }
  },
  "required": [
    "checkout_token"
  ],
  "additionalProperties": false
}