Door-Door

This API endpoint allows you to create a new FlexFlow (door-to-door) parcel request. The HTTP POST request should be sent to /parcel/logistics/door-door with the following payload in the raw request body:

{
  "pickup_origin": {
    "state_code": "LA",
    "country_code": "NG",
    "city": "Lagos",
    "address": "Ikolaba Rd, Ibadan 200285, Oyo ...",
    "region": {
      "latitude": 6.4612672,
      "longitude": 3.3961466
    },
    "contacts": {
      "name": "Olakunle Olayemi",
      "email": "abdul@gmail.com",
      "phone_number": "09020500177",
      "phone_number_2": ""
    },
    "pickup_note": "",
    "pickup_date": "",
    "pickup_time": "",
    "vehicle": ""
  },
  "destinations": [
    {
      "state_code": "LA",
      "country_code": "NG",
      "city": "Lagos",
      "address": "Ikolaba Rd, Ibadan 200285, Oyo ...",
      "region": {
        "latitude": 6.4612672,
        "longitude": 3.3961466
      },
      "contacts": {
        "name": "Olakunle Olayemi",
        "email": "abdul@gmail.com",
        "phone_number": "09020500177",
        "phone_number_2": ""
      },
      "delivery_note": "",
      "items": [
        {
          "name": "Book",
          "width": "",
          "length": "",
          "height": ""
        }
      ],
      "item_weight": 1
    }
  ]
}

The response to this request will include a JSON object with the following structure:

{
  "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-door

curl --request POST \
  --url https://api.mervii.com/beta/parcel/logistics/door-door \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "destinations": [
    {
      "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",
      "delivery_note": "",
      "item_weight": 1,
      "items": [
        {
          "height": "",
          "length": "",
          "name": "Book",
          "width": ""
        }
      ],
      "region": {
        "latitude": 6.4612672,
        "longitude": 3.3961466
      },
      "state_code": "LA"
    },
    {
      "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",
      "delivery_note": "",
      "item_weight": 1,
      "items": [
        {
          "height": "",
          "length": "",
          "name": "Book",
          "width": ""
        }
      ],
      "region": {
        "latitude": 6.4612672,
        "longitude": 3.3961466
      },
      "state_code": "LA"
    },
    {
      "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",
      "delivery_note": "",
      "item_weight": 1,
      "items": [
        {
          "height": "",
          "length": "",
          "name": "Book",
          "width": ""
        }
      ],
      "region": {
        "latitude": 6.4612672,
        "longitude": 3.3961466
      },
      "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": 6.4612672,
      "longitude": 3.3961466
    },
    "state_code": "LA",
    "vehicle": ""
  }
}'

{
  "data": {
    "discount_description": "0% discount",
    "discount_type": "Percetage",
    "status": "Pending",
    "total_amount": 10799.67,
    "total_amount_payable": 10799.67,
    "total_discount_amount": 0,
    "tracking_number": "202410083370182"
  },
  "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.

Tracking-parcel Centre-Centre

curl --request POST \
  --url https://api.mervii.com/beta/parcel/logistics/door-door \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "destinations": [
    {
      "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",
      "delivery_note": "",
      "item_weight": 1,
      "items": [
        {
          "height": "",
          "length": "",
          "name": "Book",
          "width": ""
        }
      ],
      "region": {
        "latitude": 6.4612672,
        "longitude": 3.3961466
      },
      "state_code": "LA"
    },
    {
      "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",
      "delivery_note": "",
      "item_weight": 1,
      "items": [
        {
          "height": "",
          "length": "",
          "name": "Book",
          "width": ""
        }
      ],
      "region": {
        "latitude": 6.4612672,
        "longitude": 3.3961466
      },
      "state_code": "LA"
    },
    {
      "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",
      "delivery_note": "",
      "item_weight": 1,
      "items": [
        {
          "height": "",
          "length": "",
          "name": "Book",
          "width": ""
        }
      ],
      "region": {
        "latitude": 6.4612672,
        "longitude": 3.3961466
      },
      "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": 6.4612672,
      "longitude": 3.3961466
    },
    "state_code": "LA",
    "vehicle": ""
  }
}'

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

API Documentation

CitySwift prices

FlexFlow prices

CitySwift Request

FlexFlow Request

Utils

Door-Door

Authorizations

Headers

Body

Response