mycover.ai
  • Home
  • Distributor
  • 🚀Getting Started
    • Quickstart
    • Environments
    • Authentication
    • Testing
    • Errors
    • Go Live Checklist
    • FAQs
  • 🔌Libraries & SDKs
    • Javascript
    • Vue 2
    • Vue 3
    • React
    • Flutter
    • Android
    • React Native
    • iOS
  • 📦api reference
    • Products
      • 🚘Auto
        • Aiico
        • Leadway
        • MyCoverGenius
        • Sovereign Trust
        • Coronation
        • Tangerine
        • Sanlam
      • ♥️Health
        • Hygeia
          • Hyprime Insurance
          • Hybasic Insurance
        • Bastion
          • Bastion Health
          • MediSure
        • Malaria Cover
      • 💞Personal Accident Cover
        • Aiico
        • Leadway
        • Sanlam
      • 🏠Content (Home/Office)
        • Aiico
        • Coronation
        • Sanlam
      • ✈️Travel
        • Allianz
        • Aiico
      • 💵Life Insurance
        • Credit Life
        • SME Flex
        • Flex Life
      • 🚚Goods In Transit
        • Goods In Transit (GIT)
        • Goods In Transit (GIT) On-demand
      • 💻Gadget
        • Sovereign Trust Insurance
        • Coronation
        • Tangerine
      • 🛳️Marine Insurance ✨
        • MyCoverGenius Import Marine Cover
        • Marine Cover
    • Policies
    • Claims
      • Credit Life
    • Wallet
    • Transactions
    • Customers
    • Auxiliary
      • Products
        • Bulk Purchase
  • 🧳Services
    • Webhooks
      • Validation
      • Purchase Webhook
      • Renewal Webhook
    • Messaging
Powered by GitBook
On this page
  • Buy Insurance Cover
  • Compute bulk price

Was this helpful?

  1. api reference
  2. Auxiliary
  3. Products

Bulk Purchase

PreviousProductsNextWebhooks

Last updated 8 months ago

Was this helpful?

The following APIs allows you to compute insurance premium and purchase all of our insurance products in bulk.

Buy Insurance Cover

Use this endpoint to profile insurance policies in bulk.

Please note that you can only bulk purchase one product at a time. Refer to the under the auxillary section.

POST https://api.mycover.ai/v1/products/bulk/buy-cover

Request Body

Name
Type
Description

product_id*

string

This is the ID of the product. It must be the same for every object in the payload.

payload*

array

Array of objects corresponding to the request payload of the product. Please refer to the payload for each product.

Sample Payload

This is an example of bulk purchasing Zencare Health product

{
    "product_id": "901dca29-d514-415d-abd9-1d2b9c532828",
    "payload": [
      {
          "payment_plan": 1,   
          "gender": "Male",
          "image_url": "https://via.placeholder.com/300/09f/fff.png",
          "first_name": "Vic",
          "last_name": "Man",
          "email": "glitzyken17@gmail.com",
          "dob": "2013-06-06",
          "phone": "09030601468",
          "product_id": "901dca29-d514-415d-abd9-1d2b9c532828"
        },
         {
          "payment_plan": 3,   
          "gender": "Male",
          "image_url": "https://via.placeholder.com/300/09f/fff.png",
          "first_name": "Edwards",
          "last_name": "Moses",
          "email": "moses@gmail.com",
          "dob": "2013-06-06",
          "phone": "09130601468",
          "product_id": "901dca29-d514-415d-abd9-1d2b9c532828"
        }
    ]
    
}
201 Created
{
    "responseCode": 1,
    "responseText": "Ok",
    "data": {
        "policies": [
            {
                "id": "2f2317b3-1ae7-4313-b3de-deb09b83187a",
                "app_mode": "test",
                "active": true,
                "first_name": "Hector",
                "last_name": "Man",
                "email": "glitzyken77@gmail.com",
                "dob": "2013-06-09",
                "phone": "09080601468",
                "start_date": "2024-09-06T04:01:17.000Z",
                "expiration_date": "2024-10-05T04:01:17.000Z",
                "activation_date": "2024-09-06T04:01:17.000Z",
                "distributor_id": "00f89c7d-ed60-40cf-87ab-57a7135e39c6",
                "customer_id": "1ca9ef6f-5e71-4e03-a867-f42e85fee26e",
                "buyer_id": "1ca9ef6f-5e71-4e03-a867-f42e85fee26e",
                "product_id": "901dca29-d514-415d-abd9-1d2b9c532828",
                "product_category_id": "9d78bc79-3fa8-447d-b688-e42c1c6838a0",
                "provider_id": "1343aa06-26c6-402d-902d-93792a623fbd",
                "meta": {
                    "id_image": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/92978d9d-db9d-4c7a-833d-be4e89830ee9-how-to-front-view.webp",
                    "payment_plan": 1,
                    "hmo_policy_id": "100006140",
                    "provider_expiry": "2025-05-08 23:59:59",
                    "provider_policy_id": "2058",
                    "id_card_url": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/7f24db02-f19f-4099-acd4-0b2b4e8c53ae-Hector",
                    "is_terminated_on_provider": false
                },
                "genius_price": 9000,
                "market_price": 9000,
                "purchase_id": "acdaf94d-c126-4ca5-b10f-4dd5febd315d",
                "profit": 3555,
                "submitted_to_provider": true,
                "updated_at": "2024-09-05T16:01:20.979Z",
                "created_at": "2024-09-05T16:01:17.680Z",
                "history": null,
                "deleted_at": null
            },
            {
                "id": "afdb9b50-d960-4eab-a089-922df0c122a3",
                "app_mode": "test",
                "active": true,
                "first_name": "Edwards",
                "last_name": "Moses",
                "email": "moses@gmail.com",
                "dob": "2013-06-07",
                "phone": "09130601468",
                "start_date": "2024-09-06T04:01:22.000Z",
                "expiration_date": "2024-12-04T04:01:22.000Z",
                "activation_date": "2024-09-06T04:01:22.000Z",
                "distributor_id": "00f89c7d-ed60-40cf-87ab-57a7135e39c6",
                "customer_id": "25b0d12c-0a6a-4978-a137-5e9adbe3b0f1",
                "buyer_id": "25b0d12c-0a6a-4978-a137-5e9adbe3b0f1",
                "product_id": "901dca29-d514-415d-abd9-1d2b9c532828",
                "product_category_id": "9d78bc79-3fa8-447d-b688-e42c1c6838a0",
                "provider_id": "1343aa06-26c6-402d-902d-93792a623fbd",
                "meta": {
                    "id_image": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/92978d9d-db9d-4c7a-833d-be4e89830ee9-how-to-front-view.webp",
                    "payment_plan": 3,
                    "hmo_policy_id": "100006141",
                    "provider_expiry": "2025-05-08 23:59:59",
                    "provider_policy_id": "2058",
                    "id_card_url": "https://s3.eu-west-2.amazonaws.com/staging.mycover.ai/8180ec64-de60-452d-98f4-2c310977573b-Edwards",
                    "is_terminated_on_provider": false
                },
                "genius_price": 27000,
                "market_price": 27000,
                "purchase_id": "4e208488-9ed6-4add-947b-d166f02b891f",
                "profit": 10665,
                "submitted_to_provider": true,
                "updated_at": "2024-09-05T16:01:25.037Z",
                "created_at": "2024-09-05T16:01:22.385Z",
                "history": null,
                "deleted_at": null
            }
        ],
        "errors": []
    }
}

Compute bulk price

Use this endpoint to compute price for bulk purchase

POST https://api.mycover.ai/v1/products/bulk/compute-price

Request Body

Name
Type
Description

product_id*

string

This is the ID of the product. It must be the same for every object in the payload.

payload*

array

Array of objects corresponding to the request payload of the product. Please refer to the payload for each product.

Sample payload

{
    "product_id": "901dca29-d514-415d-abd9-1d2b9c532828",
    "payload": [
      {
          "payment_plan": 1,   
          "gender": "Male",
          "image_url": "https://via.placeholder.com/300/09f/fff.png",
          "first_name": "Vic",
          "last_name": "Man",
          "email": "glitzyken17@gmail.com",
          "dob": "2013-06-06",
          "phone": "09030601468",
          "product_id": "901dca29-d514-415d-abd9-1d2b9c532828"
        },
         {
          "payment_plan": 3,   
          "gender": "Male",
          "image_url": "https://via.placeholder.com/300/09f/fff.png",
          "first_name": "Edwards",
          "last_name": "Moses",
          "email": "moses@gmail.com",
          "dob": "2013-06-06",
          "phone": "09130601468",
          "product_id": "901dca29-d514-415d-abd9-1d2b9c532828"
        }
    ]
    
}
200 Ok
{
    "responseCode": 1,
    "responseText": "Price computed successfully",
    "data": {
        "price": 36000
    }
}

Please note that you can only compute bulk price for one product at a time. Refer to the under the auxillary section.

📦
products page
products page