Overview

Skipcart APIs & webhooks provide a one-stop experience to allow for seamless partner delivery experiences. Integration with Skipcart out of the box APIs can instantly position any partner or POS to offer on-demand delivery services using their existing interface.

The Basics

Skipcart offers a suite of out of the box RESTful APIs which can be tailored to partner requirements. The APIs accept and return JSON-encoded objects and utilize standard HTTP response codes. Skipcart also offers standard webhook functions for partners who do not have a predefined set of webhooks.

The table below represents the full list of available APIs which interface with Skipcart.

API

Method

Functionality

Required?

Authentication

POST

Authenticates a user via API call

Y

Get Serviceable Zip Codes

POST

Retrieves a list of zip codes serviced by Skipcart, called before quoting

N

Recommended for Quote Based Partners

Get Quote

POST

Get a quote from Skipcart for an order

Required for Quote Based Partners

Create Order

POST

Creates an Order in Skipcart systems

Y

Get Status of an Order

GET

Retrieve the status of a single order (Webhooks can be utilized alternatively)

Y

Delete Order

DELETE

Deletes an order from Skipcart

Y

Search Orders

GET

Search one or more orders in Skipcart systems

N

Post Order Tipping

POST

Add tip for individual order to pass to driver AFTER the order is delivered to customer

N

Skipcart Webhooks

POST

Update partners with status of orders as they progress; webhook events are published to a partner provided endpoint

N

Sunny Day Process Flow

200

At a high level, the sunny day order flow consists of the below:

  • Partner authenticates - once every 24 hours
  • Partner retrieves Skipcart serviceable zip codes
  • Partner requests quote from Skipcart
  • Partner submits order to Skipcart to fulfill delivery
  • Partner queries Skipcart to retrieve order status which is updated real time as webhooks & events are triggered
  • If post order tipped is received from delivery recipient, Post Order Tipping API can be used to pass tip onto driver