intral-city

This endpoint allows you to create a new CitySwiift (intral city) parcel delivery order. The request should be sent as an HTTP POST to /parcel/intral/intral-city.

Request Body

The request should include a JSON payload with the following structure:

pickup_origin: Details of the pickup location including region, city, state code, country code, and contact information.
destinations: An array containing details of the delivery destinations including region, formatted address, city, neighborhood, ward, local, state, state code, country, country code, postal code, and contact information.

Response

The response will be in JSON format and will include the following fields:

status: Indicates the status of the request (true/false).
message: Additional information or error message.
data: Contains the details of the created parcel order including tracking number, status, total amount, total discount amount, total amount payable, discount type, and discount description.

POST

parcel

intral

intral-city

curl --request POST \
  --url https://api.mervii.com/beta/parcel/intral/intral-city \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "destinations": [
    {
      "city": "Ojodu Berger",
      "contacts": {
        "email": "abdul@gmail.com",
        "name": "Olakunle Olayemi",
        "phone_number": "09020500177",
        "phone_number_2": "09020500177"
      },
      "country": "Nigeria",
      "country_code": "NG",
      "formattedAddress": "Olowora, Ojodu Berger 105102, Lagos, Nigeria",
      "lat": 6.6395189,
      "lng": 3.3710171,
      "local": "Kosofe",
      "neighborhood": "Olowora",
      "postal_code": "105102",
      "region": {
        "latitude": 6.6395189,
        "longitude": 3.3710171
      },
      "state": "Lagos",
      "state_code": "LA",
      "ward": "Isheri-Olowo-Ira/Shangisha/Magodo Phase I & II"
    }
  ],
  "pickup_origin": {
    "city": "Ikeja",
    "contacts": {
      "email": "abdul@gmail.com",
      "name": "Olakunle Olayemi",
      "phone_number": "09020500177",
      "phone_number_2": "09020500177"
    },
    "country_code": "NG",
    "region": {
      "latitude": 6.594019599999999,
      "longitude": 3.336365099999999
    },
    "state_code": "LA"
  }
}'

{
  "data": {
    "discount_description": "See the destination parcel details",
    "discount_type": "percentage",
    "status": "Pending",
    "total_amount": 1427,
    "total_amount_payable": 1427,
    "total_discount_amount": 0,
    "tracking_number": "202410082201832"
  },
  "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.

curl --request POST \
  --url https://api.mervii.com/beta/parcel/intral/intral-city \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "destinations": [
    {
      "city": "Ojodu Berger",
      "contacts": {
        "email": "abdul@gmail.com",
        "name": "Olakunle Olayemi",
        "phone_number": "09020500177",
        "phone_number_2": "09020500177"
      },
      "country": "Nigeria",
      "country_code": "NG",
      "formattedAddress": "Olowora, Ojodu Berger 105102, Lagos, Nigeria",
      "lat": 6.6395189,
      "lng": 3.3710171,
      "local": "Kosofe",
      "neighborhood": "Olowora",
      "postal_code": "105102",
      "region": {
        "latitude": 6.6395189,
        "longitude": 3.3710171
      },
      "state": "Lagos",
      "state_code": "LA",
      "ward": "Isheri-Olowo-Ira/Shangisha/Magodo Phase I & II"
    }
  ],
  "pickup_origin": {
    "city": "Ikeja",
    "contacts": {
      "email": "abdul@gmail.com",
      "name": "Olakunle Olayemi",
      "phone_number": "09020500177",
      "phone_number_2": "09020500177"
    },
    "country_code": "NG",
    "region": {
      "latitude": 6.594019599999999,
      "longitude": 3.336365099999999
    },
    "state_code": "LA"
  }
}'

{
  "data": {
    "discount_description": "See the destination parcel details",
    "discount_type": "percentage",
    "status": "Pending",
    "total_amount": 1427,
    "total_amount_payable": 1427,
    "total_discount_amount": 0,
    "tracking_number": "202410082201832"
  },
  "message": "Parcel is successful",
  "status": true
}

intral-city

This endpoint allows you to create a new CitySwiift (intral city) parcel delivery order. The request should be sent as an HTTP POST to /parcel/intral/intral-city.

Request Body

The request should include a JSON payload with the following structure:

pickup_origin: Details of the pickup location including region, city, state code, country code, and contact information.
destinations: An array containing details of the delivery destinations including region, formatted address, city, neighborhood, ward, local, state, state code, country, country code, postal code, and contact information.

Response

The response will be in JSON format and will include the following fields:

status: Indicates the status of the request (true/false).
message: Additional information or error message.
data: Contains the details of the created parcel order including tracking number, status, total amount, total discount amount, total amount payable, discount type, and discount description.

POST

parcel

intral

intral-city

curl --request POST \
  --url https://api.mervii.com/beta/parcel/intral/intral-city \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "destinations": [
    {
      "city": "Ojodu Berger",
      "contacts": {
        "email": "abdul@gmail.com",
        "name": "Olakunle Olayemi",
        "phone_number": "09020500177",
        "phone_number_2": "09020500177"
      },
      "country": "Nigeria",
      "country_code": "NG",
      "formattedAddress": "Olowora, Ojodu Berger 105102, Lagos, Nigeria",
      "lat": 6.6395189,
      "lng": 3.3710171,
      "local": "Kosofe",
      "neighborhood": "Olowora",
      "postal_code": "105102",
      "region": {
        "latitude": 6.6395189,
        "longitude": 3.3710171
      },
      "state": "Lagos",
      "state_code": "LA",
      "ward": "Isheri-Olowo-Ira/Shangisha/Magodo Phase I & II"
    }
  ],
  "pickup_origin": {
    "city": "Ikeja",
    "contacts": {
      "email": "abdul@gmail.com",
      "name": "Olakunle Olayemi",
      "phone_number": "09020500177",
      "phone_number_2": "09020500177"
    },
    "country_code": "NG",
    "region": {
      "latitude": 6.594019599999999,
      "longitude": 3.336365099999999
    },
    "state_code": "LA"
  }
}'

{
  "data": {
    "discount_description": "See the destination parcel details",
    "discount_type": "percentage",
    "status": "Pending",
    "total_amount": 1427,
    "total_amount_payable": 1427,
    "total_discount_amount": 0,
    "tracking_number": "202410082201832"
  },
  "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.

curl --request POST \
  --url https://api.mervii.com/beta/parcel/intral/intral-city \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "destinations": [
    {
      "city": "Ojodu Berger",
      "contacts": {
        "email": "abdul@gmail.com",
        "name": "Olakunle Olayemi",
        "phone_number": "09020500177",
        "phone_number_2": "09020500177"
      },
      "country": "Nigeria",
      "country_code": "NG",
      "formattedAddress": "Olowora, Ojodu Berger 105102, Lagos, Nigeria",
      "lat": 6.6395189,
      "lng": 3.3710171,
      "local": "Kosofe",
      "neighborhood": "Olowora",
      "postal_code": "105102",
      "region": {
        "latitude": 6.6395189,
        "longitude": 3.3710171
      },
      "state": "Lagos",
      "state_code": "LA",
      "ward": "Isheri-Olowo-Ira/Shangisha/Magodo Phase I & II"
    }
  ],
  "pickup_origin": {
    "city": "Ikeja",
    "contacts": {
      "email": "abdul@gmail.com",
      "name": "Olakunle Olayemi",
      "phone_number": "09020500177",
      "phone_number_2": "09020500177"
    },
    "country_code": "NG",
    "region": {
      "latitude": 6.594019599999999,
      "longitude": 3.336365099999999
    },
    "state_code": "LA"
  }
}'

{
  "data": {
    "discount_description": "See the destination parcel details",
    "discount_type": "percentage",
    "status": "Pending",
    "total_amount": 1427,
    "total_amount_payable": 1427,
    "total_discount_amount": 0,
    "tracking_number": "202410082201832"
  },
  "message": "Parcel is successful",
  "status": true
}

intral-city

Request Body

Response

Authorizations

Headers

Body

Response

Introduction

Mobile

intral-city

Request Body

Response

Authorizations

Headers

Body

Response