MyCover AI
Operational APIs

Products

This section details all the endpoints needed to manage your products.

Fetch all products under your business

List all the products available to you. This endpoint allows you to query all your products details.

GET

https://v2.api.mycover.ai/v2/products/all

Query Parameters

NameTypeDescription
pagenumberPage number of response
limitnumberNumber of data to show per fetch
searchstringSearch products by name, category name, or provider name
category_idstringFilter products by category id. Can take multiple ids, e.g ?category_id=123&category_id=456

Response

200 OK
{
    "responseCode": 1,
    "responseText": "Products fetched successfully",
    "data": {
        "total_count": 34,
        "products": [
            {
                "id": "d4751c39-8500-4238-881a-fb05b8f18cd4",
                "name": "MediSure",
                "description": "A health insurance product designed to provide peace of mind and financial protection for our customers.",
                "base_price": "1000.0000",
                "cover_period": "30",
                "full_benefits": "<p><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">This plan covers people with quality healthcare at ₦1,000 per month.</span></p><p><br></p><p><strong style=\"background-color: transparent; color: rgb(0, 0, 0);\">Delivery and Ante-natal Care</strong></p><p><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">Protection for delivery and ante-natal care including assisted deliveries and caesarean section.</span></p><p><strong style=\"background-color: transparent; color: rgb(34, 34, 34);\">Treatment of everyday illnesses</strong></p><p><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">Access to treatment for basic medical outpatient and in-patient cases including microbiology tests.</span></p><p><strong style=\"background-color: transparent; color: rgb(34, 34, 34);\">Accident and Emergency care</strong></p><p><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">Resuscitative care for accident and emergency cases, including basic radiological and laboratory investigations needed to stabilize patients before ICU.</span></p><p><strong style=\"background-color: transparent; color: rgb(34, 34, 34);\">Major and Minor Surgeries</strong></p><p><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">Safeguard customers against severe health conditions with access to 26 different types of surgeries.</span></p><p><strong style=\"background-color: transparent; color: rgb(34, 34, 34);\">24 hours Telemedicine</strong></p><p><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">Customers get free consultations with health experts when needed.</span></p><p><strong style=\"background-color: transparent; color: rgb(34, 34, 34);\">Dental and Eye Care</strong></p><p><span style=\"background-color: transparent; color: rgb(0, 0, 0);\">Enhance customers' overall well-being with healthcare that covers treatment for both their eyes and dentition.</span></p>",
                "how_it_works": "<ul><li>Each person will get an e-HMO ID generated automatically.</li><li>The E-ID can be taken to any available hospital under the plan to get healthcare.</li><li>At the hospital, the HMO ID is presented as a means of verification to receive healthcare without paying.</li></ul>",
                "stability_percentage": 100,
                "provider": {
                    "id": "04e7e852-0c80-4c62-8a24-c5f4a5e5c6d6",
                    "organization_name": "Bastion"
                },
                "country": {
                    "id": "758d3834-5488-4603-bc41-4f542dd3de87",
                    "name": "Nigeria"
                },
                "currency": {
                    "id": "29dbe1da-218d-4b9d-bd43-8870055471a7",
                    "name": "Nigerian Naira"
                },
                "category": {
                    "id": "9d78bc79-3fa8-447d-b688-e42c1c6838a0",
                    "name": "Health"
                }
            },
            // ...
        ]
    }
}

Get one product details by ID

GET

https://v2.api.mycover.ai/v2/products/:productId

Response

200 OK
{
  "responseCode": 1,
  "responseText": "Products fetched successfully",
  "data": {
    "id": "d4751c39-8500-4238-881a-fb05b8f18cd4",
    "name": "MediSure",
    "prefix": "bastion",
    "route_name": "bastion-medisure",
    "is_renewable": true,
    "is_claimable": false,
    "is_inspectable": false,
    "is_certificateable": false,
    "prevent_duplicate_purchase": true,
    "is_multi_sharing_formula": false,
    "base_price": "10000.0000",
    "cover_period": "30",
    "is_active": true,
    "category_id": "9d78bc79-3fa8-447d-b688-e42c1c6838a0",
    "provider_id": "04e7e852-0c80-4c62-8a24-c5f4a5e5c6d6",
    "stability_percentage": 100,
    "country_id": "bb67ae67-53d1-4810-be05-33043115399c",
    "currency_id": "6b3147f9-aa5b-4fd9-934d-ee5a179db989",
    "created_at": "2025-07-31T17:38:40.991Z",
    "updated_at": "2025-10-14T12:38:07.428Z",
    "provider": {
      "id": "04e7e852-0c80-4c62-8a24-c5f4a5e5c6d6",
      "organization_name": "Bastion"
    },
    "country": {
      "id": "bb67ae67-53d1-4810-be05-33043115399c",
      "name": "Nigeria"
    },
    "currency": {
      "id": "6b3147f9-aa5b-4fd9-934d-ee5a179db989",
      "name": "Nigerian Naira"
    },
    "category": {
      "id": "9d78bc79-3fa8-447d-b688-e42c1c6838a0",
      "name": "Health"
    }
  }
}

Fetch All Product Categories

GET

https://v2.api.mycover.ai/v2/categories

Response

200 OK
{
    "responseCode": 1,
    "responseText": "Product categories fetched successfully",
    "data": [
        {
            "id": "14fb5968-48d2-49ac-88a8-0ee40e01fcca",
            "name": "Package",
            "created_at": "2021-09-03T14:59:35.475Z",
            "product_count": "4",
            "provider_count": "1"
        },
        {
            "id": "1e87194d-5eb1-48b6-8837-a9cbc78d4ec3",
            "name": "Gadget",
            "created_at": "2021-09-03T14:59:35.392Z",
            "product_count": "3",
            "provider_count": "2"
        },
        // ...
    ]
}