Tracking-parcel

curl --request POST \
  --url https://api.mervii.com/beta/parcel/intral/track-parcel \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tracking_number": "202410082201832"
}
'

{
  "data": {
    "created_at": "2024-10-08T20:31:51.000Z",
    "destinations": [
      {
        "city": "Ojodu Berger",
        "contacts": {
          "email": "[email protected]",
          "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",
        "price": {
          "amount": 1427,
          "amount_payable": 1427,
          "discount_amount": 0,
          "discount_description": "0% discount",
          "discount_type": "percentage",
          "distance": "7.1 km",
          "duration": "17 mins"
        },
        "region": {
          "latitude": 6.6395189,
          "longitude": 3.3710171
        },
        "state": "Lagos",
        "state_code": "LA",
        "ward": "Isheri-Olowo-Ira/Shangisha/Magodo Phase I & II"
      }
    ],
    "discount_description": "See the destination parcel details",
    "discount_type": "percentage",
    "pickup_origin": {
      "city": "Ikeja",
      "contacts": {
        "email": "[email protected]",
        "name": "Olakunle Olayemi",
        "phone_number": "09020500177",
        "phone_number_2": "09020500177"
      },
      "country_code": "NG",
      "region": {
        "latitude": 6.594019599999999,
        "longitude": 3.336365099999999
      },
      "state_code": "LA"
    },
    "ref": null,
    "status": "Pending",
    "total_amount": "1427.00",
    "total_amount_payable": "1427.00",
    "total_discount_amount": "0.00",
    "tracking_number": "202410082201832",
    "updated_at": "2024-10-08T20:31:51.000Z"
  },
  "message": "",
  "status": true
}

Tracking-parcel

Track Parcel

This endpoint allows you to track a parcel by providing the tracking number.

Request Body

tracking_number (string): The tracking number of the parcel.

Response

status (boolean): Indicates if the request was successful.
message (string): A message related to the request.
data (object): Contains information about the parcel and its journey.
- pickup_origin (object): Details about the origin of the parcel pickup.
  - city (string): City of origin.
  - region (object): Geographic coordinates of the origin region.
  - contacts (object): Contact information for the origin pickup.
  - state_code (string): Code for the origin state.
  - country_code (string): Code for the origin country.
- destinations (array): Array of destination objects containing details about the parcel’s journey.
  - lat (number): Latitude of the destination.
  - lng (number): Longitude of the destination.
  - city (string): City of the destination.
  - ward (string): Ward of the destination.
  - local (string): Local information of the destination.
  - price (object): Details about the price and discount for the destination.
  - state (string): State of the destination.
  - region (object): Geographic coordinates of the destination region.
  - country (string): Country of the destination.
  - contacts (object): Contact information for the destination.
  - state_code (string): Code for the destination state.
  - postal_code (string): Postal code of the destination.
  - country_code (string): Code for the destination country.
  - neighborhood (string): Neighborhood of the destination.
  - formattedAddress (string): Formatted address of the destination.
- tracking_number (string): The tracking number of the parcel.
- status (string): Status of the parcel.
- total_amount (string): Total amount related to the parcel.
- total_discount_amount (string): Total discount amount related to the parcel.
- total_amount_payable (string): Total amount payable for the parcel.
- discount_type (string): Type of discount applied.
- discount_description (string): Description of the discount.
- ref (string): Reference related to the parcel.
- created_at (string): Date and time of creation.
- updated_at (string): Date and time of last update.

POST

parcel

intral

track-parcel

Tracking-parcel

curl --request POST \
  --url https://api.mervii.com/beta/parcel/intral/track-parcel \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "tracking_number": "202410082201832"
}
'

{
  "data": {
    "created_at": "2024-10-08T20:31:51.000Z",
    "destinations": [
      {
        "city": "Ojodu Berger",
        "contacts": {
          "email": "[email protected]",
          "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",
        "price": {
          "amount": 1427,
          "amount_payable": 1427,
          "discount_amount": 0,
          "discount_description": "0% discount",
          "discount_type": "percentage",
          "distance": "7.1 km",
          "duration": "17 mins"
        },
        "region": {
          "latitude": 6.6395189,
          "longitude": 3.3710171
        },
        "state": "Lagos",
        "state_code": "LA",
        "ward": "Isheri-Olowo-Ira/Shangisha/Magodo Phase I & II"
      }
    ],
    "discount_description": "See the destination parcel details",
    "discount_type": "percentage",
    "pickup_origin": {
      "city": "Ikeja",
      "contacts": {
        "email": "[email protected]",
        "name": "Olakunle Olayemi",
        "phone_number": "09020500177",
        "phone_number_2": "09020500177"
      },
      "country_code": "NG",
      "region": {
        "latitude": 6.594019599999999,
        "longitude": 3.336365099999999
      },
      "state_code": "LA"
    },
    "ref": null,
    "status": "Pending",
    "total_amount": "1427.00",
    "total_amount_payable": "1427.00",
    "total_discount_amount": "0.00",
    "tracking_number": "202410082201832",
    "updated_at": "2024-10-08T20:31:51.000Z"
  },
  "message": "",
  "status": true
}

Authorizations

Authorization

string

header

required

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

Body

application/json

tracking_number

string

Example:

"202410082201832"

Response

200 - application/json

success

data

object

Show child attributes

data.created_at

string

Example:

"2024-10-08T20:31:51.000Z"

data.destinations

object[]

Show child attributes

data.destinations.city

string

Example:

"Ojodu Berger"

data.destinations.contacts

object

Show child attributes

data.destinations.contacts.email

string

Example:

"[email protected]"

data.destinations.contacts.name

string

Example:

"Olakunle Olayemi"

data.destinations.contacts.phone_number

string

Example:

"09020500177"

data.destinations.contacts.phone_number_2

string

Example:

"09020500177"

data.destinations.country

string

Example:

"Nigeria"

data.destinations.country_code

string

Example:

"NG"

data.destinations.formattedAddress

string

Example:

"Olowora, Ojodu Berger 105102, Lagos, Nigeria"

data.destinations.lat

number

Example:

6.6395189

data.destinations.lng

number

Example:

3.3710171

data.destinations.local

string

Example:

"Kosofe"

data.destinations.neighborhood

string

Example:

"Olowora"

data.destinations.postal_code

string

Example:

"105102"

data.destinations.price

object

Show child attributes

data.destinations.price.amount

number

Example:

1427

data.destinations.price.amount_payable

number

Example:

1427

data.destinations.price.discount_amount

number

Example:

0

data.destinations.price.discount_description

string

Example:

"0% discount"

data.destinations.price.discount_type

string

Example:

"percentage"

data.destinations.price.distance

string

Example:

"7.1 km"

data.destinations.price.duration

string

Example:

"17 mins"

data.destinations.region

object

Show child attributes

data.destinations.region.latitude

number

Example:

6.6395189

data.destinations.region.longitude

number

Example:

3.3710171

data.destinations.state

string

Example:

"Lagos"

data.destinations.state_code

string

Example:

"LA"

data.destinations.ward

string

Example:

"Isheri-Olowo-Ira/Shangisha/Magodo Phase I & II"

Example:

[
  {
    "city": "Ojodu Berger",
    "contacts": {
      "email": "[email protected]",
      "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",
    "price": {
      "amount": 1427,
      "amount_payable": 1427,
      "discount_amount": 0,
      "discount_description": "0% discount",
      "discount_type": "percentage",
      "distance": "7.1 km",
      "duration": "17 mins"
    },
    "region": {
      "latitude": 6.6395189,
      "longitude": 3.3710171
    },
    "state": "Lagos",
    "state_code": "LA",
    "ward": "Isheri-Olowo-Ira/Shangisha/Magodo Phase I & II"
  }
]

data.discount_description

string

Example:

"See the destination parcel details"

data.discount_type

string

Example:

"percentage"

data.pickup_origin

object

Show child attributes

data.pickup_origin.city

string

Example:

"Ikeja"

data.pickup_origin.contacts

object

Show child attributes

data.pickup_origin.contacts.email

string

Example:

"[email protected]"

data.pickup_origin.contacts.name

string

Example:

"Olakunle Olayemi"

data.pickup_origin.contacts.phone_number

string

Example:

"09020500177"

data.pickup_origin.contacts.phone_number_2

string

Example:

"09020500177"

data.pickup_origin.country_code

string

Example:

"NG"

data.pickup_origin.region

object

Show child attributes

data.pickup_origin.region.latitude

number

Example:

6.594019599999999

data.pickup_origin.region.longitude

number

Example:

3.336365099999999

data.pickup_origin.state_code

string

Example:

"LA"

data.ref

unknown

data.status

string

Example:

"Pending"

data.total_amount

string

Example:

"1427.00"

data.total_amount_payable

string

Example:

"1427.00"

data.total_discount_amount

string

Example:

"0.00"

data.tracking_number

string

Example:

"202410082201832"

data.updated_at

string

Example:

"2024-10-08T20:31:51.000Z"

message

string

Example:

""

status

boolean

Example:

true

intral-city Door-Door

⌘I

API Documentation

CitySwift prices

FlexFlow prices

CitySwift Request

FlexFlow Request

Utils

Tracking-parcel

Track Parcel

Request Body

Response

Authorizations

Body

Response