Swoove 360
  • Overview
  • About
  • Authentication
  • Errors
  • API reference
    • Estimates
    • Delivery
    • Delivery Information
    • Update Delivery
    • Extras
    • Wallet
    • Service Zones
    • Webhook Reference
    • Models
Powered by GitBook
On this page

Was this helpful?

  1. API reference

Delivery

PreviousEstimatesNextDelivery Information

Was this helpful?

  • POSTCreate a delivery request
  • POSTCreate Bulk Delivery Request

Create a delivery request

post

Create a new delivery. If a callback URL was provided, delivery status updates will be sent to that URL. See CallbackDeliveryPayload for the structure of the data sent.

Authorizations
Query parameters
app_keystringRequired
Body
all ofOptional
and
Responses
200
Success Responses On Delivery Creation Request
application/json
Responseall of
400
Validation Error
application/json
500
Requesting Delivery Failed
post
POST /delivery/create-delivery HTTP/1.1
Host: test.swooveapi.com
Content-Type: application/json
Accept: */*
Content-Length: 571

{
  "pickup": {
    "type": "text",
    "value": "text",
    "contact": {
      "name": "text",
      "mobile": "text",
      "email": "text"
    },
    "country_code": "GH",
    "lat": 1,
    "lng": 1,
    "location": "text"
  },
  "dropoff": {
    "type": "text",
    "value": "text",
    "contact": {
      "name": "text",
      "mobile": "text",
      "email": "text"
    },
    "country_code": "GH",
    "lat": 1,
    "lng": 1,
    "location": "text"
  },
  "items": [
    {
      "itemName": "text",
      "itemQuantity": 1,
      "itemCost": 1,
      "description": "text",
      "itemWeight": 1,
      "is_fragile": false,
      "dimensions": {
        "x": 1,
        "y": 1,
        "z": 1
      }
    }
  ],
  "contact": {
    "name": "text",
    "mobile": "text",
    "email": "text"
  },
  "instructions": "text",
  "reference": "text",
  "estimate_id": "text"
}
{
  "success": true,
  "code": 200,
  "message": "Estimate completed",
  "responses": {
    "pickup": {
      "type": "text",
      "value": "text",
      "contact": {
        "name": "text",
        "mobile": "text",
        "email": "text"
      },
      "country_code": "GH",
      "lat": 1,
      "lng": 1,
      "location": "text"
    },
    "dropoff": {
      "type": "text",
      "value": "text",
      "contact": {
        "name": "text",
        "mobile": "text",
        "email": "text"
      },
      "country_code": "GH",
      "lat": 1,
      "lng": 1,
      "location": "text"
    },
    "items": [
      {
        "itemName": "text",
        "itemQuantity": 1,
        "itemCost": 1,
        "description": "text",
        "itemWeight": 1,
        "is_fragile": false,
        "dimensions": {
          "x": 1,
          "y": 1,
          "z": 1
        }
      }
    ],
    "contact": {
      "name": "text",
      "mobile": "text",
      "email": "text"
    },
    "instructions": "text",
    "reference": "text",
    "estimate_id": "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"
    }
  }
}

Create Bulk Delivery Request

post
Authorizations
Query parameters
app_keystringRequired
Body

Bulk Delivery Request Structure

estimate_idstringOptional

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

Responses
200
Bulk Delivery Created
application/json
Responseall of
400
Validation Error
application/json
500
Getting Estimates Failed
post
POST /bulk-delivery/create-bulk-delivery HTTP/1.1
Host: test.swooveapi.com
Content-Type: application/json
Accept: */*
Content-Length: 592

{
  "delivery_list": [
    {
      "pickup": {
        "type": "text",
        "value": "text",
        "contact": {
          "name": "text",
          "mobile": "text",
          "email": "text"
        },
        "country_code": "GH",
        "lat": 1,
        "lng": 1,
        "location": "text"
      },
      "dropoff": {
        "type": "text",
        "value": "text",
        "contact": {
          "name": "text",
          "mobile": "text",
          "email": "text"
        },
        "country_code": "GH",
        "lat": 1,
        "lng": 1,
        "location": "text"
      },
      "items": [
        {
          "itemName": "text",
          "itemQuantity": 1,
          "itemCost": 1,
          "description": "text",
          "itemWeight": 1,
          "is_fragile": false,
          "dimensions": {
            "x": 1,
            "y": 1,
            "z": 1
          }
        }
      ],
      "contacts": {
        "name": "text",
        "mobile": "text",
        "email": "text"
      },
      "instructions": "text",
      "reference": "text"
    }
  ],
  "estimate_id": "text"
}
{
  "success": true,
  "code": 200,
  "message": "Estimate completed",
  "responses": [
    {
      "pickup": {
        "type": "text",
        "value": "text",
        "contact": {
          "name": "text",
          "mobile": "text",
          "email": "text"
        },
        "country_code": "GH",
        "lat": 1,
        "lng": 1,
        "location": "text"
      },
      "dropoff": {
        "type": "text",
        "value": "text",
        "contact": {
          "name": "text",
          "mobile": "text",
          "email": "text"
        },
        "country_code": "GH",
        "lat": 1,
        "lng": 1,
        "location": "text"
      },
      "items": [
        {
          "itemName": "text",
          "itemQuantity": 1,
          "itemCost": 1,
          "description": "text",
          "itemWeight": 1,
          "is_fragile": false,
          "dimensions": {
            "x": 1,
            "y": 1,
            "z": 1
          }
        }
      ],
      "contacts": {
        "name": "text",
        "mobile": "text",
        "email": "text"
      },
      "status": "PENDING",
      "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"
      },
      "waybill_link": "text",
      "tracking_link": "text",
      "time_completed": 1
    }
  ]
}