Delivery

The POST API is used to create new resources, the GET API is used to retrieve existing resources, the DELETE API is used to remove resources, and the UPDATE API is used to modify existing resources.

PreviousEstimates NextService zone

Last updated 5 months ago

Was this helpful?

Create Delivery Request

POSThttps://test.swooveapi.com/bulk-delivery/create-bulk-delivery

Authorization

Query parameters

Body

Bulk Delivery Request Body Sample and Schema

delivery_listarray of all of

estimate_idstring

The estimate id of the selected estimate that was returned during the create delivery estimate request

Response

Bulk Delivery Created

Body

successboolean

status of request true for success and false for failed request

codeinteger (int32)

code for reason for failure

messagestring

responsesarray of all of

Bulk Delivery(s) Details

Request

const response = await fetch('https://test.swooveapi.com/bulk-delivery/create-bulk-delivery?app_key=text', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "delivery_list": [
        {
          "pickup": {
            "type": "text",
            "contact": {
              "name": null,
              "mobile": "text",
              "email": null
            },
            "country_code": "GH",
            "lat": null,
            "lng": null,
            "location": null
          },
          "dropoff": {
            "type": "text",
            "contact": {
              "name": null,
              "mobile": "text",
              "email": null
            },
            "country_code": "GH",
            "lat": null,
            "lng": null,
            "location": null
          },
          "items": [],
          "vehicle_type": "MOTORCYCLE",
          "contacts": {
            "name": null,
            "mobile": "text",
            "email": null
          },
          "instructions": null
        }
      ]
    }),
});
const data = await response.json();

Response

{
  "success": true,
  "code": 200,
  "message": "Estimate completed",
  "responses": [
    {
      "pickup": {
        "type": "text",
        "contact": {
          "name": null,
          "mobile": "text",
          "email": null
        },
        "country_code": "GH",
        "lat": null,
        "lng": null,
        "location": null
      },
      "dropoff": {
        "type": "text",
        "contact": {
          "name": null,
          "mobile": "text",
          "email": null
        },
        "country_code": "GH",
        "lat": null,
        "lng": null,
        "location": null
      },
      "items": [],
      "vehicle_type": "MOTORCYCLE",
      "contacts": {
        "name": null,
        "mobile": "text",
        "email": null
      },
      "time": 1,
      "distance": 1,
      "delivery_type": "SHARED",
      "status": "AGENCY_ASSIGNED",
      "delivery_code": "text",
      "secret_code": "text",
      "instructions": "text",
      "reference": "text",
      "full_price": {
        "discount": 0,
        "value": 0,
        "currency_code": "GHS",
        "currency_symbol": "₵",
        "currency_name": "Ghanaian cedi"
      },
      "bulk_id": "text",
      "waybill_link": "text",
      "tracking_link": "text"
    }
  ]
}

Get Delivery By Delivery Code

GEThttps://test.swooveapi.com/delivery/get-delivery/{delivery-code}

Authorization

Path parameters

delivery-code*string

Delivery Code

Query parameters

Response

Delivery Found

Body

successboolean

status of request true for success and false for failed request

codeinteger (int32)

code for reason for failure

messagestring

responsesall of

Request

const response = await fetch('https://test.swooveapi.com/delivery/get-delivery/{delivery-code}?app_key=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "success": true,
  "code": 200,
  "message": "Delivery Found",
  "responses": {
    "pickup": {
      "type": "text",
      "contact": {
        "name": null,
        "mobile": "text",
        "email": null
      },
      "country_code": "GH",
      "lat": null,
      "lng": null,
      "location": null
    },
    "dropoff": {
      "type": "text",
      "contact": {
        "name": null,
        "mobile": "text",
        "email": null
      },
      "country_code": "GH",
      "lat": null,
      "lng": null,
      "location": null
    },
    "items": [],
    "vehicle_type": "MOTORCYCLE",
    "contact": {
      "name": null,
      "mobile": "text",
      "email": null
    },
    "instructions": null,
    "reference": "text",
    "estimate_id": "text",
    "time": 1,
    "distance": 1,
    "delivery_type": "SHARED",
    "agent_details": {
      "agent_first_name": "text",
      "agent_last_name": "text",
      "agent_mobile": "text",
      "agent_picture": "text",
      "license_type": "text",
      "license_number": "text",
      "license_expiry": 1
    },
    "agency_details": {
      "name": "Agency Name",
      "mobile_number": 23350484565,
      "logo": "text",
      "rating": 1,
      "location": {
        "country_code": "GH",
        "latitude": 0,
        "longitude": 0,
        "city": "text",
        "country": "text"
      }
    },
    "vehicle_details": {
      "brand": "text",
      "model": "text",
      "color": "text",
      "picture": "text",
      "vehicle_type": "MOTORCYCLE",
      "license_plate_number": "text",
      "insurance_provider": "text"
    },
    "status": "AGENCY_ASSIGNED",
    "delivery_code": "text",
    "secret_code": "text",
    "timestamp": 1,
    "full_price": {
      "discount": 0,
      "value": 0,
      "currency_code": "GHS",
      "currency_symbol": "₵",
      "currency_name": "Ghanaian cedi"
    }
  }
}

Get Delivery By reference

GEThttps://test.swooveapi.com/delivery/single/get-by-reference/{reference}

Authorization

Path parameters

reference*string

Reference submitted during delivery creation

Query parameters

Response

Delivery Found

Body

successboolean

status of request true for success and false for failed request

codeinteger (int32)

code for reason for failure

messagestring

responsesall of

Request

const response = await fetch('https://test.swooveapi.com/delivery/single/get-by-reference/{reference}?app_key=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "success": true,
  "code": 200,
  "message": "Delivery Found",
  "responses": {
    "pickup": {
      "type": "text",
      "contact": {
        "name": null,
        "mobile": "text",
        "email": null
      },
      "country_code": "GH",
      "lat": null,
      "lng": null,
      "location": null
    },
    "dropoff": {
      "type": "text",
      "contact": {
        "name": null,
        "mobile": "text",
        "email": null
      },
      "country_code": "GH",
      "lat": null,
      "lng": null,
      "location": null
    },
    "items": null,
    "vehicle_type": "MOTORCYCLE",
    "instructions": null,
    "reference": "text",
    "status": "text",
    "delivery_code": "text",
    "secret_code": "text",
    "time": 1,
    "end_time": 1,
    "distance": 1,
    "delivery_type": "SHARED",
    "full_price": {
      "discount": 0,
      "value": 0,
      "currency_code": "GHS",
      "currency_symbol": "₵",
      "currency_name": "Ghanaian cedi"
    }
  }
}

Get Bulk Delivery By reference

GEThttps://test.swooveapi.com/delivery/bulk/get-by-reference/{reference}

Authorization

Path parameters

reference*string

Reference submitted during delivery creation

Query parameters

Response

Delivery Found

Body

successboolean

status of request true for success and false for failed request

codeinteger (int32)

code for reason for failure

messagestring

responsesarray of all of

Request

const response = await fetch('https://test.swooveapi.com/delivery/bulk/get-by-reference/{reference}?app_key=text', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "success": true,
  "code": 200,
  "message": "Delivery Found",
  "responses": [
    {
      "pickup": {
        "type": "text",
        "contact": {
          "name": null,
          "mobile": "text",
          "email": null
        },
        "country_code": "GH",
        "lat": null,
        "lng": null,
        "location": null
      },
      "dropoff": {
        "type": "text",
        "contact": {
          "name": null,
          "mobile": "text",
          "email": null
        },
        "country_code": "GH",
        "lat": null,
        "lng": null,
        "location": null
      },
      "items": null,
      "vehicle_type": "MOTORCYCLE",
      "instructions": null,
      "reference": "text",
      "status": "text",
      "delivery_code": "text",
      "secret_code": "text",
      "time": 1,
      "end_time": 1,
      "distance": 1,
      "delivery_type": "SHARED",
      "full_price": {
        "discount": 0,
        "value": 0,
        "currency_code": "GHS",
        "currency_symbol": "₵",
        "currency_name": "Ghanaian cedi"
      }
    }
  ]
}

Simulate a delivery action in test enviroment only.

Note that the actions need to be triggered in this order

ASSIGNED
PICKUP
PICKEDUP
DROPOFF
DROPEDOFF
ENDED

POSThttps://test.swooveapi.com/delivery/simulate-action

Query parameters

Body

Simulate Action For Deliveries

delivery_code*string

simulate_status*enum

ASSIGNEDPICKUPPICKEDUPDROPOFFDROPEDOFFENDED

secret_code*string

delivery secret code to be used in triggering ENDED status

Response

Success Responses On Delivery Simulation

Body

successboolean

status of request true for success and false for failed request

codeinteger (int32)

code for reason for failure

messagestring

Deliveries assigned to agent, trip created

responsesstring

Request

const response = await fetch('https://test.swooveapi.com/delivery/simulate-action?app_key=text', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "delivery_code": "The delivery code from the delivery that you want to simulate the action for. The delivery should already be created for this to happen",
      "simulate_status": "ASSIGNED",
      "secret_code": "text"
    }),
});
const data = await response.json();

Response

{
  "success": true,
  "code": 200,
  "message": "text",
  "responses": null
}

Cancel a delivery

NB: Only deliveries that are not running can be canncelled. That is deliveries with status PENDING,AGENCY_ASSIGNED,ONHOLD,REASSIGNED and PICKUP

PUThttps://test.swooveapidev.com/delivery/cancel-delivery

Authorization

Query parameters

Response

Delivery Cancelled

Body

successboolean

status of request true for success and false for failed request

codeinteger (int32)

code for reason for failure

messagestring

responsesall of

Request

const response = await fetch('https://test.swooveapidev.com/delivery/cancel-delivery?app_key=text', {
    method: 'PUT',
    headers: {},
});
const data = await response.json();

Response

{
  "success": true,
  "code": 200,
  "message": "Delivery Cancelled",
  "responses": {
    "pickup": {
      "type": "text",
      "value": "text",
      "contact": {
        "name": null,
        "mobile": "text",
        "email": null
      },
      "country_code": "GH",
      "lat": null,
      "lng": null,
      "location": null
    },
    "dropoff": {
      "type": "text",
      "value": "text",
      "contact": {
        "name": null,
        "mobile": "text",
        "email": null
      },
      "country_code": "GH",
      "lat": null,
      "lng": null,
      "location": null
    },
    "items": null,
    "vehicle_type": "MOTORCYCLE",
    "instructions": null,
    "reference": "text",
    "status": "text",
    "delivery_code": "text",
    "secret_code": "text",
    "time": 1,
    "end_time": 1,
    "distance": 1,
    "delivery_type": "SHARED",
    "full_price": {
      "discount": 0,
      "value": 0,
      "currency_code": "GHS",
      "currency_symbol": "₵",
      "currency_name": "Ghanaian cedi"
    }
  }
}