Intelligent Foods API Overview

Intelligent Foods’ Partner API empowers business partners to market and sell Intelligent Foods items via a comprehensive standards-based connection to Intelligent Foods’ backend catalog and fulfillment systems.

What it Is

  • A JSON REST API over HTTPS.
  • The authentication is OAuth 2 with Client Credentials Flow.
  • Dropshipping – place orders with Intelligent Foods and we ship directly to your customers.
  • Every order is distinct and independent, not a subscription or reoccurring.
  • Orders may be placed, modified, or cancelled up to 3 weeks in advance. Orders are not materialized until the cut-off deadline.
  • Available Functionality:
    • Menus – retrieve the full menu of Intelligent Foods items available on a weekly basis including: meal kits, Fresh and Ready meals, per-meal protein upgrades, and market items.
    • Item details – retrieve comprehensive data on any item including: descriptions, images, prices, ingredients, allergens, nutrition, diet types, portions, sizes, servings, instructions, cook times, and images.
    • Availability – retrieve real-time location specific deliverability and sold-out status of all items.
    • Order Simulation – ability to place a test order with no persistent effect to ensure order parameters are correct, order items are available, and location specific delivery is available and valid.
    • Order CRUD operations – create, read, update, and delete Order transactions.
    • Deliverable Zip codes look up – you get a list of zip codes to which Intelligent Foods can deliver orders. This data should be cached, since it doesn’t change very often.
    • Search and retrieve Orders – by various criteria including arbitrary partner supplied reference IDs.
    • Order Status and Delivery Progress – partners may register any URL to receive real-time Webhook callbacks regarding Orders processing status changes and delivery progress, including carrier tracking information.
    • Customizable delivery day – you or your customer select the day on which they wish to receive their order. Depending on the delivery zip code there are typically multiple delivery days available per week, Sunday through Thursday.
    • A “staging” environment is available, essentially identical to production, free to use for on-boarding and testing as needed.
    • Comprehensive developer documentation: terminology reference, authentication flow, sequence diagrams, and full endpoint documentation in industry standard OpenAPI format.
    • Industry standard SLA and AUP.

What it is Not

  • A subscription – every order is distinct. Place orders for your customers on a weekly basis as needed, we’ll only ship the orders we receive via the API.
  • Your customers are yours; we do not directly communicate with your customers regarding order status or delivery progress. We provide real-time Webhook callbacks to empower you to inform your customers regarding their order status as you see fit.
  • No user management. You access the API as a client application, not an individual user. The API has no concept of a user beyond the details needed to deliver the order.
  • Fulfillment is not customizable – you or your customer selects the delivery day, we select the carrier, means of delivery, and packaging (boxes, ice, and insulation) to get the order to them on that day in food safe temperatures.
  • We do not process payments via the API in any capacity. You bill your customers as you see fit, we bill you on a regular basis for the orders placed or as otherwise agreed upon in our business contract.