Centre-Door

curl --request POST \
  --url https://api.mervii.com/beta/price/centre-door \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "destinations": [
    {
      "city": "",
      "country_code": "NG",
      "item_weight": 1,
      "region": {
        "latitude": 7.427026700000001,
        "longitude": 3.8900142
      },
      "state_code": "LA"
    },
    {
      "city": "",
      "country_code": "NG",
      "item_weight": 1,
      "region": {
        "latitude": 7.427026700000001,
        "longitude": 3.8900142
      },
      "state_code": "LA"
    }
  ],
  "pickup_origin": {
    "addresss": "",
    "centre_code": "",
    "country_code": "",
    "state_code": ""
  }
}
'

{
  "data": {
    "destinations": [
      {
        "city": null,
        "country_code": "NG",
        "dropoff_centre": {
          "centre_code": "lagos-ojodu-berger",
          "centre_name": "Ojodu Berger Lagos"
        },
        "item_weight": 1,
        "price": {
          "amount": 11692.520875080363,
          "amount_payable": 11692.520875080363,
          "discount_amount": 0,
          "discount_description": "0% discount",
          "discount_type": "Percetage",
          "distance": "68.26634062567 Kilometres to the drop off center ",
          "duration": "1-4 days"
        },
        "region": {
          "latitude": 7.427026700000001,
          "longitude": 3.8900142
        },
        "state_code": "LA",
        "weight": "1"
      },
      {
        "city": null,
        "country_code": "NG",
        "dropoff_centre": {
          "centre_code": "lagos-ojodu-berger",
          "centre_name": "Ojodu Berger Lagos"
        },
        "item_weight": 1,
        "price": {
          "amount": 11692.520875080363,
          "amount_payable": 11692.520875080363,
          "discount_amount": 0,
          "discount_description": "0% discount",
          "discount_type": "Percetage",
          "distance": "68.26634062567 Kilometres to the drop off center ",
          "duration": "1-4 days"
        },
        "region": {
          "latitude": 7.427026700000001,
          "longitude": 3.8900142
        },
        "state_code": "LA",
        "weight": "1"
      }
    ],
    "discount_description": "0% discount",
    "discount_type": "Percetage",
    "pickup_origin": {
      "addresss": null,
      "centre_code": "ibadan-sango",
      "country_code": null,
      "pickup_centre": {
        "centre_code": "ibadan-sango",
        "centre_name": "Sango Ibadan"
      },
      "state_code": null
    },
    "total_amount": 23385.041750160726,
    "total_amount_payable": 23385.041750160726,
    "total_discount_amount": 0
  },
  "message": "get price",
  "status": true
}

Centre-Door

Centre(hub) to Door (home delivery) Price Calculation

This API endpoint allows you to calculate the price for delivering items from a pickup center to one or more destinations.

Request Body

pickup_origin (object)
- state_code (string, optional): The state code of the pickup origin.
- country_code (string, optional): The country code of the pickup origin.
- centre_code (string): The code of the pickup center.
- address (string, optional): The address of the pickup origin.
destinations (array)
- country_code (string): The country code of the destination.
- state_code (string): The state code of the destination.
- city (string, optional): The city of the destination.
- region (object)
  - latitude (number): The latitude of the destination.
  - longitude (number): The longitude of the destination.
- item_weight (number): The weight of the item to be delivered.

Response Body (JSON Schema)

{
  "type": "object",
  "properties": {
    "status": {
      "type": "boolean"
    },
    "message": {
      "type": "string"
    },
    "data": {
      "type": "object",
      "properties": {
        "pickup_origin": {
          "type": "object",
          "properties": {
            "state_code": { "type": ["string", "null"] },
            "country_code": { "type": ["string", "null"] },
            "centre_code": { "type": "string" },
            "address": { "type": ["string", "null"] },
            "pickup_centre": {
              "type": "object",
              "properties": {
                "centre_code": { "type": "string" },
                "centre_name": { "type": "string" }
              }
            }
          }
        },
        "destinations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "country_code": { "type": "string" },
              "state_code": { "type": "string" },
              "city": { "type": ["string", "null"] },
              "region": {
                "type": "object",
                "properties": {
                  "latitude": { "type": "number" },
                  "longitude": { "type": "number" }
                }
              },
              "item_weight": { "type": "number" },
              "dropoff_centre": {
                "type": "object",
                "properties": {
                  "centre_code": { "type": "string" },
                  "centre_name": { "type": "string" }
                }
              },
              "price": {
                "type": "object",
                "properties": {
                  "amount": { "type": "number" },
                  "discount_amount": { "type": "number" },
                  "amount_payable": { "type": "number" },
                  "discount_type": { "type": "string" },
                  "discount_description": { "type": "string" },
                  "distance": { "type": "string" },
                  "duration": { "type": "string" },
                  "weight": { "type": "string" }
                }
              }
            }
          }
        },
        "total_amount": { "type": "number" },
        "total_discount_amount": { "type": "number" },
        "total_amount_payable": { "type": "number" },
        "discount_type": { "type": "string" },
        "discount_description": { "type": "string" }
      }
    }
  }
}

POST

price

centre-door

Centre-Door

curl --request POST \
  --url https://api.mervii.com/beta/price/centre-door \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "destinations": [
    {
      "city": "",
      "country_code": "NG",
      "item_weight": 1,
      "region": {
        "latitude": 7.427026700000001,
        "longitude": 3.8900142
      },
      "state_code": "LA"
    },
    {
      "city": "",
      "country_code": "NG",
      "item_weight": 1,
      "region": {
        "latitude": 7.427026700000001,
        "longitude": 3.8900142
      },
      "state_code": "LA"
    }
  ],
  "pickup_origin": {
    "addresss": "",
    "centre_code": "",
    "country_code": "",
    "state_code": ""
  }
}
'

{
  "data": {
    "destinations": [
      {
        "city": null,
        "country_code": "NG",
        "dropoff_centre": {
          "centre_code": "lagos-ojodu-berger",
          "centre_name": "Ojodu Berger Lagos"
        },
        "item_weight": 1,
        "price": {
          "amount": 11692.520875080363,
          "amount_payable": 11692.520875080363,
          "discount_amount": 0,
          "discount_description": "0% discount",
          "discount_type": "Percetage",
          "distance": "68.26634062567 Kilometres to the drop off center ",
          "duration": "1-4 days"
        },
        "region": {
          "latitude": 7.427026700000001,
          "longitude": 3.8900142
        },
        "state_code": "LA",
        "weight": "1"
      },
      {
        "city": null,
        "country_code": "NG",
        "dropoff_centre": {
          "centre_code": "lagos-ojodu-berger",
          "centre_name": "Ojodu Berger Lagos"
        },
        "item_weight": 1,
        "price": {
          "amount": 11692.520875080363,
          "amount_payable": 11692.520875080363,
          "discount_amount": 0,
          "discount_description": "0% discount",
          "discount_type": "Percetage",
          "distance": "68.26634062567 Kilometres to the drop off center ",
          "duration": "1-4 days"
        },
        "region": {
          "latitude": 7.427026700000001,
          "longitude": 3.8900142
        },
        "state_code": "LA",
        "weight": "1"
      }
    ],
    "discount_description": "0% discount",
    "discount_type": "Percetage",
    "pickup_origin": {
      "addresss": null,
      "centre_code": "ibadan-sango",
      "country_code": null,
      "pickup_centre": {
        "centre_code": "ibadan-sango",
        "centre_name": "Sango Ibadan"
      },
      "state_code": null
    },
    "total_amount": 23385.041750160726,
    "total_amount_payable": 23385.041750160726,
    "total_discount_amount": 0
  },
  "message": "get price",
  "status": true
}

Authorizations

Authorization

string

header

required

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

Body

application/json

destinations

object[]

Show child attributes

destinations.city

string

Example:

""

destinations.country_code

string

Example:

"NG"

destinations.item_weight

number

Example:

1

destinations.region

object

Show child attributes

destinations.region.latitude

number

Example:

7.427026700000001

destinations.region.longitude

number

Example:

3.8900142

destinations.state_code

string

Example:

"LA"

Example:

[
  {
    "city": "",
    "country_code": "NG",
    "item_weight": 1,
    "region": {
      "latitude": 7.427026700000001,
      "longitude": 3.8900142
    },
    "state_code": "LA"
  },
  {
    "city": "",
    "country_code": "NG",
    "item_weight": 1,
    "region": {
      "latitude": 7.427026700000001,
      "longitude": 3.8900142
    },
    "state_code": "LA"
  }
]

pickup_origin

object

Show child attributes

pickup_origin.addresss

string

Example:

""

pickup_origin.centre_code

string

Example:

""

pickup_origin.country_code

string

Example:

""

pickup_origin.state_code

string

Example:

""

Response

success

data

object

Show child attributes

data.destinations

object[]

Show child attributes

data.destinations.city

unknown

data.destinations.country_code

string

Example:

"NG"

data.destinations.dropoff_centre

object

Show child attributes

data.destinations.dropoff_centre.centre_code

string

Example:

"lagos-ojodu-berger"

data.destinations.dropoff_centre.centre_name

string

Example:

"Ojodu Berger Lagos"

data.destinations.item_weight

number

Example:

1

data.destinations.price

object

Show child attributes

data.destinations.price.amount

number

Example:

11692.520875080363

data.destinations.price.amount_payable

number

Example:

11692.520875080363

data.destinations.price.discount_amount

number

Example:

0

data.destinations.price.discount_description

string

Example:

"0% discount"

data.destinations.price.discount_type

string

Example:

"Percetage"

data.destinations.price.distance

string

Example:

"68.26634062567 Kilometres to the drop off center "

data.destinations.price.duration

string

Example:

"1-4 days"

data.destinations.region

object

Show child attributes

data.destinations.region.latitude

number

Example:

7.427026700000001

data.destinations.region.longitude

number

Example:

3.8900142

data.destinations.state_code

string

Example:

"LA"

data.destinations.weight

string

Example:

"1"

Example:

[
  {
    "city": null,
    "country_code": "NG",
    "dropoff_centre": {
      "centre_code": "lagos-ojodu-berger",
      "centre_name": "Ojodu Berger Lagos"
    },
    "item_weight": 1,
    "price": {
      "amount": 11692.520875080363,
      "amount_payable": 11692.520875080363,
      "discount_amount": 0,
      "discount_description": "0% discount",
      "discount_type": "Percetage",
      "distance": "68.26634062567 Kilometres to the drop off center ",
      "duration": "1-4 days"
    },
    "region": {
      "latitude": 7.427026700000001,
      "longitude": 3.8900142
    },
    "state_code": "LA",
    "weight": "1"
  },
  {
    "city": null,
    "country_code": "NG",
    "dropoff_centre": {
      "centre_code": "lagos-ojodu-berger",
      "centre_name": "Ojodu Berger Lagos"
    },
    "item_weight": 1,
    "price": {
      "amount": 11692.520875080363,
      "amount_payable": 11692.520875080363,
      "discount_amount": 0,
      "discount_description": "0% discount",
      "discount_type": "Percetage",
      "distance": "68.26634062567 Kilometres to the drop off center ",
      "duration": "1-4 days"
    },
    "region": {
      "latitude": 7.427026700000001,
      "longitude": 3.8900142
    },
    "state_code": "LA",
    "weight": "1"
  }
]

data.discount_description

string

Example:

"0% discount"

data.discount_type

string

Example:

"Percetage"

data.pickup_origin

object

Show child attributes

data.pickup_origin.addresss

unknown

data.pickup_origin.centre_code

string

Example:

"ibadan-sango"

data.pickup_origin.country_code

unknown

data.pickup_origin.pickup_centre

object

Show child attributes

data.pickup_origin.pickup_centre.centre_code

string

Example:

"ibadan-sango"

data.pickup_origin.pickup_centre.centre_name

string

Example:

"Sango Ibadan"

data.pickup_origin.state_code

unknown

data.total_amount

number

Example:

23385.041750160726

data.total_amount_payable

number

Example:

23385.041750160726

data.total_discount_amount

number

Example:

0

message

string

Example:

"get price"

status

boolean

Example:

true

⌘I

API Documentation

CitySwift prices

FlexFlow prices

CitySwift Request

FlexFlow Request

Utils

Centre-Door

Centre(hub) to Door (home delivery) Price Calculation

Request Body

Response Body (JSON Schema)

Authorizations

Body

Response