Door-centre

This API endpoint allows you to create a new logistics order for door-to-centre parcel delivery. The request should be sent as an HTTP POST to /parcel/logistics/door-centre.

Request Body

The request body should be sent in raw format and should include the following parameters:

pickup_origin: Details of the pickup location including region, state code, country code, city, address, contacts, pickup note, pickup date, pickup time, and vehicle.
destinations: An array containing details of the destination centre, including centre code, state code, country code, city, address, contacts, delivery note, items, and item weight.

Response

Upon successful creation of the logistics order, the API will respond with the following parameters:

status: A boolean indicating the status of the request.
message: An optional message related to the request.
data: An object containing details of the created order, including tracking number, status, total amount, total discount amount, total amount payable, discount type, and discount description.

Example Response:

{
    "status": true,
    "message": "",
    "data": {
        "tracking_number": "",
        "status": "",
        "total_amount": 0,
        "total_discount_amount": 0,
        "total_amount_payable": 0,
        "discount_type": "",
        "discount_description": ""
    }
}

POST

parcel

logistics

door-centre

curl --request POST \
  --url https://api.mervii.com/beta/parcel/logistics/door-centre \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "destinations": [
    {
      "address": "Ikolaba Rd, Ibadan 200285, Oyo, Nigeria",
      "centre_code": "",
      "city": "Lagos",
      "contacts": {
        "email": "abdul@gmail.com",
        "name": "Olakunle Olayemi",
        "phone_number": "09020500177",
        "phone_number_2": ""
      },
      "country_code": "NG",
      "delivery_note": "",
      "item_weight": 1,
      "items": [
        {
          "height": "",
          "length": "",
          "name": "Book",
          "width": ""
        }
      ],
      "state_code": "LA"
    }
  ],
  "pickup_origin": {
    "address": "Ikolaba Rd, Ibadan 200285, Oyo, Nigeria",
    "city": "Lagos",
    "contacts": {
      "email": "abdul@gmail.com",
      "name": "Olakunle Olayemi",
      "phone_number": "09020500177",
      "phone_number_2": ""
    },
    "country_code": "NG",
    "pickup_date": "",
    "pickup_note": "",
    "pickup_time": "",
    "region": {
      "latitude": 7.427026700000001,
      "longitude": 3.8900142
    },
    "state_code": "LA",
    "vehicle": ""
  }
}'

{
  "data": {
    "discount_description": "0% discount",
    "discount_type": "Percetage",
    "status": "Pending",
    "total_amount": 11192.940875080363,
    "total_amount_payable": 11192.940875080363,
    "total_discount_amount": 0,
    "tracking_number": "202410086789949"
  },
  "message": "Parcel is successful",
  "status": true
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

cache-control

string

Example:

"no-cache"

postman-token

string

Example:

"<calculated when request is sent>"

content-length

string

Example:

"<calculated when request is sent>"

host

string

Example:

"<calculated when request is sent>"

user-agent

string

Example:

"PostmanRuntime/7.39.1"

accept-encoding

string

Example:

"gzip, deflate, br"

connection

string

Example:

"keep-alive"

Body

application/json

Response

200

application/json

success

The response is of type object.

Centre-Door Track-parcel

curl --request POST \
  --url https://api.mervii.com/beta/parcel/logistics/door-centre \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "destinations": [
    {
      "address": "Ikolaba Rd, Ibadan 200285, Oyo, Nigeria",
      "centre_code": "",
      "city": "Lagos",
      "contacts": {
        "email": "abdul@gmail.com",
        "name": "Olakunle Olayemi",
        "phone_number": "09020500177",
        "phone_number_2": ""
      },
      "country_code": "NG",
      "delivery_note": "",
      "item_weight": 1,
      "items": [
        {
          "height": "",
          "length": "",
          "name": "Book",
          "width": ""
        }
      ],
      "state_code": "LA"
    }
  ],
  "pickup_origin": {
    "address": "Ikolaba Rd, Ibadan 200285, Oyo, Nigeria",
    "city": "Lagos",
    "contacts": {
      "email": "abdul@gmail.com",
      "name": "Olakunle Olayemi",
      "phone_number": "09020500177",
      "phone_number_2": ""
    },
    "country_code": "NG",
    "pickup_date": "",
    "pickup_note": "",
    "pickup_time": "",
    "region": {
      "latitude": 7.427026700000001,
      "longitude": 3.8900142
    },
    "state_code": "LA",
    "vehicle": ""
  }
}'

{
  "data": {
    "discount_description": "0% discount",
    "discount_type": "Percetage",
    "status": "Pending",
    "total_amount": 11192.940875080363,
    "total_amount_payable": 11192.940875080363,
    "total_discount_amount": 0,
    "tracking_number": "202410086789949"
  },
  "message": "Parcel is successful",
  "status": true
}

API Documentation

CitySwift prices

FlexFlow prices

CitySwift Request

FlexFlow Request

Utils

Door-centre

Request Body

Response

Authorizations

Headers

Body

Response