KFC

Check KFC delivery serviceability and estimated fee for one store and address

Checks whether a KFC restaurant's delivery integration can deliver to a given address and, when it can, the estimated delivery fee (broken down by fee line item) and pickup/dropoff time. This reads the same checkout-time estimate KFC's own site calls -- it does not add an item to a cart or place an order, and takes no payment or account information. serviceable is true only when the upstream returned a real estimate; a false value with reason populated covers every other case seen live: the delivery provider not enabled at this store, the address being outside the delivery zone, or the delivery marketplace itself reporting the store temporarily inactive. order_subtotal materially affects the fee estimate (KFC's own fee schedules can vary by order size), so it is required rather than defaulted. pickup_at defaults to 30 minutes from now (an "order now" style estimate) when omitted.

get/kfc/delivery-estimate

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/kfc/delivery-estimate
  • Auth: API key in header x-api-key

Query parameters

store_numberstring required

KFC's alphanumeric store number, from /kfc/stores or /kfc/nearby

address1string required

Delivery address line 1

address2string

Delivery address line 2

citystring required

Delivery address city

statestring required

Delivery address state, two-letter code

postal_codestring required

Delivery address postal code

country_codestring

Delivery address country code (default US)

latitudenumber required

Delivery address latitude

longitudenumber required

Delivery address longitude

order_subtotalnumber required

Order subtotal before fees, in dollars

pickup_atstring

RFC3339 pickup time (default 30 minutes from now)

delivery_provider'DOORDASH' | 'MOCK_DOORDASH' | 'INTERNAL'

Delivery provider to check (default DOORDASH)

Headers

x-api-keystring required

API key required

Response

OK

codeinteger

Code is the HTTP status code or a custom code used to indicate the result of the request @example 200

msgunknown

Example response

{
  "data": {
    "delivery_provider": "DOORDASH",
    "fee": {
      "amount": 4.99,
      "amount_cents": 499,
      "currency_code": "USD"
    },
    "fees": [
      {
        "amount": {
          "amount": 4.99,
          "amount_cents": 499,
          "currency_code": "USD"
        },
        "name": "Delivery Fee",
        "type": "DELIVERY"
      }
    ],
    "reason": "Marketplace store is inactive",
    "store_number": "K750015"
  }
}

Changes

No recorded changes to this operation across all 3 revisions of this API.