Terminal Shipping API
  • Introduction
  • Example Book Shipment Flow
  • Ship with Code
  • Authentication
  • Errors
  • Libraries & Plugins
  • API ENDPOINTS
  • Addresses
    • Create Address
    • Get Addresses
    • Get Address
    • Update Address
    • Validate Address
    • Set Default Sender Address
    • Get Default Sender Address
  • Carriers
    • Get Carriers
    • Get Carrier
    • Enable Carrier
    • Enable Multiple Carriers
    • Disable Carrier
    • Disable Multiple Carriers
    • Drop-off Locations
  • Claims
    • Get Claims
    • Get Claim
    • File Claim
  • HS Codes
    • Get HSCodes
    • Get HSCode Chapters
    • Get HSCode Categories
    • Get HSCode Details
    • Search HSCodes
  • Insurance
    • Get Insurance
    • Get Insurances List
    • Get Insurance Premium
    • Get Insurance Premium Using Parcel Value
    • Purchase Insurance
  • Packaging
    • Create Packaging
    • Update Packaging
    • Get Packaging
    • Terminal Default Packaging
    • Get Specific Packaging
  • Parcels
    • Create Parcel
    • Update Parcel
    • Get Parcels
    • Get Parcel
  • Rates
    • Get Rates for Shipment
    • Get Quotes for Shipment
    • Get Rates for Multi-Parcel Shipment
    • Get Rates
    • Get Rate
  • Simplified HS Codes
    • Get Simplified HSCodes
    • Get Simplified HSCode Chapters
    • Get Simplified HSCode Categories
    • Get Simplified HSCode Details
    • Search Simplified HSCodes
  • Shipments
    • Create Shipment
    • Create Quick Shipment
    • Update Shipment
    • Get Shipments
    • Get Shipments v2
    • Get Shipment
    • Track a Shipment
    • Cancel Shipment
    • Delete Shipment
    • Duplicate Shipment
    • Arrange Pickup & Delivery for Shipment
  • Transactions
    • Get Transactions
    • Get Transaction
  • Users
    • Get User
    • Get Wallet Info
    • Get Wallet Balance
    • Get User Carriers
  • Webhooks
    • Create Webhook
    • Delete Webhook
    • Disable Webhook
    • Enable Webhook
    • Get Webhooks
    • Get Webhook
  • MISCALLANEOUS
    • Carriers Available
    • Carrier Object
    • Cities
    • Countries
    • File Claim Object
    • Parcel Item
    • Quick Shipments
      • Parcel
      • Pickup / Delivery Address
    • Shipment Events
    • Shipment Extras
    • States
    • Webhook Events
      • Handling Webhook Events
    • Volumetric Weight
Powered by GitBook
On this page

Was this helpful?

  1. Insurance

Purchase Insurance

Purchase insurance for a specific shipment.

/insurance/purchase

POST https://api.terminal.africa/v1/insurance/purchase

This endpoint allows you to purchase insurance coverage for a shipment.

Headers

Name
Type
Description

Authorization*

String

Set value to Bearer SECRET_KEY

Content-Type

String

Set value to application/json

Request Body

Name
Type
Description

shipment*

String

Unique shipment_id reference. Insurance can only be purchased for confirmed shipment.

{
    "status": true,
    "message": "Insurance purchased successfully.",
    "data": {
        "amount": 600,
        "claim": "",
        "currency": "NGN",
        "metadata": {
            "platform": "octamile",
            "reference": "tqjiz9ch2khd3jwi02zn4ffw79t8v8su"
        },
        "parcel": "PC-09857312356",
        "partner_charge": 500,
        "shipment": "SH-18651243607",
        "status": "pending",
        "user": "USER-27450202164",
        "value": 100000,
        "_id": "637c36f314560407e635a861",
        "insurance_id": "IN-96948763342",
        "created_at": "2022-11-22T02:41:55.584Z",
        "updated_at": "2022-11-22T02:41:55.584Z",
        "__v": 0,
        "id": "637c36f314560407e635a861"
    }
}
PreviousGet Insurance Premium Using Parcel ValueNextPackaging

Last updated 2 years ago

Was this helpful?