Door - Centre

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

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

Door - Centre

Home Pickup to Cenntre (Hub)

The endpoint is used to calculate the price for delivering items from a pickup origin (home pickup) to one or more destinations, with a specific centre for the destination.

Request Payload

pickup_origin (object): Contains the details of the pickup origin including the country code, state code, city, and region coordinates.
- country_code (string): The country code of the pickup origin.
- state_code (string): The state code of the pickup origin.
- city (string): The city of the pickup origin.
- region (object): The coordinates of the pickup origin region.
  - latitude (number): The latitude of the pickup origin.
  - longitude (number): The longitude of the pickup origin.
destinations (array): Contains an array of destination details.
- state_code (string): The state code of the destination.
- country_code (string): The country code of the destination.
- centre_code (string): The code of the destination centre.
- addresss (string): The address of the destination.
- item_weight (number): The weight of the item to be delivered to the destination.

Response

The response for this request can be represented as a JSON schema:

{
  "type": "object",
  "properties": {
    "status": { "type": "boolean" },
    "message": { "type": "string" },
    "data": {
      "type": "object",
      "properties": {
        "pickup_origin": {
          "type": "object",
          "properties": {
            "country_code": { "type": "string" },
            "state_code": { "type": "string" },
            "city": { "type": "string" },
            "region": {
              "type": "object",
              "properties": {
                "latitude": { "type": "number" },
                "longitude": { "type": "number" }
              }
            },
            "pickup_centre": {
              "type": "object",
              "properties": {
                "centre_code": { "type": "string" },
                "centre_name": { "type": "string" }
              }
            }
          }
        },
        "destinations": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "state_code": { "type": "string" },
              "country_code": { "type": "string" },
              "centre_code": { "type": "string" },
              "addresss": { "type": "string" },
              "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" }
      }
    }
  }
}

This JSON schema represents the structure of the response data returned by the API endpoint.

POST

price

door-centre

Door - Centre

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

{
  "data": {
    "destinations": [
      {
        "addresss": null,
        "centre_code": "ibadan-sango",
        "country_code": null,
        "dropoff_centre": {
          "centre_code": "ibadan-sango",
          "centre_name": "Sango Ibadan"
        },
        "item_weight": 1,
        "price": {
          "amount": 3000.98,
          "amount_payable": 3000.98,
          "discount_amount": 0,
          "discount_description": "0% discount",
          "discount_type": "Percetage",
          "distance": " Kilometres to the drop off center ",
          "duration": "1-4 days"
        },
        "state_code": null,
        "weight": "1"
      }
    ],
    "discount_description": "0% discount",
    "discount_type": "Percetage",
    "pickup_origin": {
      "city": null,
      "country_code": "NG",
      "pickup_centre": {
        "centre_code": "lagos-ojodu-berger",
        "centre_name": "Ojodu Berger Lagos"
      },
      "region": {
        "latitude": 7.427026700000001,
        "longitude": 3.8900142
      },
      "state_code": "LA"
    },
    "total_amount": 11192.940875080363,
    "total_amount_payable": 11192.940875080363,
    "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.addresss

string

Example:

""

destinations.centre_code

string

Example:

""

destinations.country_code

string

Example:

""

destinations.item_weight

number

Example:

1

destinations.state_code

string

Example:

""

Example:

[
  {
    "addresss": "",
    "centre_code": "",
    "country_code": "",
    "item_weight": 1,
    "state_code": ""
  }
]

pickup_origin

object

Show child attributes

pickup_origin.city

string

Example:

""

pickup_origin.country_code

string

Example:

"NG"

pickup_origin.region

object

Show child attributes

pickup_origin.region.latitude

number

Example:

7.427026700000001

pickup_origin.region.longitude

number

Example:

3.8900142

pickup_origin.state_code

string

Example:

"LA"

Response

success

data

object

Show child attributes

data.destinations

object[]

Show child attributes

data.destinations.addresss

unknown

data.destinations.centre_code

string

Example:

"ibadan-sango"

data.destinations.country_code

unknown

data.destinations.dropoff_centre

object

Show child attributes

data.destinations.dropoff_centre.centre_code

string

Example:

"ibadan-sango"

data.destinations.dropoff_centre.centre_name

string

Example:

"Sango Ibadan"

data.destinations.item_weight

number

Example:

1

data.destinations.price

object

Show child attributes

data.destinations.price.amount

number

Example:

3000.98

data.destinations.price.amount_payable

number

Example:

3000.98

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:

" Kilometres to the drop off center "

data.destinations.price.duration

string

Example:

"1-4 days"

data.destinations.state_code

unknown

data.destinations.weight

string

Example:

"1"

Example:

[
  {
    "addresss": null,
    "centre_code": "ibadan-sango",
    "country_code": null,
    "dropoff_centre": {
      "centre_code": "ibadan-sango",
      "centre_name": "Sango Ibadan"
    },
    "item_weight": 1,
    "price": {
      "amount": 3000.98,
      "amount_payable": 3000.98,
      "discount_amount": 0,
      "discount_description": "0% discount",
      "discount_type": "Percetage",
      "distance": " Kilometres to the drop off center ",
      "duration": "1-4 days"
    },
    "state_code": null,
    "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.city

unknown

data.pickup_origin.country_code

string

Example:

"NG"

data.pickup_origin.pickup_centre

object

Show child attributes

data.pickup_origin.pickup_centre.centre_code

string

Example:

"lagos-ojodu-berger"

data.pickup_origin.pickup_centre.centre_name

string

Example:

"Ojodu Berger Lagos"

data.pickup_origin.region

object

Show child attributes

data.pickup_origin.region.latitude

number

Example:

7.427026700000001

data.pickup_origin.region.longitude

number

Example:

3.8900142

data.pickup_origin.state_code

string

Example:

"LA"

data.total_amount

number

Example:

11192.940875080363

data.total_amount_payable

number

Example:

11192.940875080363

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

Door - Centre

Request Payload

Response

Authorizations

Body

Response