Operational APIs
Sales
View all purchases and renewals made by your customers
View a list of all the transactions you’ve done on your integration. This endpoint describes how to view customer purchases and renewals. You can also query specific transactions using the appropriate reference.
View Purchases and Renewals
See a list of all the purchases and renewals made by your customers.
GET
https://v2.api.mycover.ai/v2/purchases
Query Parameters
| Name | Type | Description |
|---|---|---|
| page | number | Page number of response |
| limit | number | Number of data to show per fetch |
| is_renewal | boolean | Filter purchases by renewal |
| search | string | Filter purchases by search query |
| created_at_start | string | Filter purchases by start date |
| created_at_end | string | Filter purchases by end date |
Response
200 OK
{
"responseCode": 1,
"responseText": "Purchases fetched successfully",
"data": {
"total_result": 125,
"total_count": 125,
"purchases": [
{
"id": "50d4ef41-ba21-4309-8b09-8eff0d13886f",
"app_mode": "test",
"is_renewal": false,
"amount": "50000.0000",
"customer_id": "70b33e7f-bbb4-42c2-ad92-29c20ee0e9ab",
"distributor_id": "5a32b459-8c3b-46bc-b699-0c5902824b1b",
"payment_channel": "none",
"payment_option": "wallet",
"policy_id": "507d32df-4b25-462b-ac5a-d26d63468e67",
"product_category_id": "978ced0d-0e05-4de6-b43a-b408c0e8b95e",
"product_id": "0ced01f3-7698-4101-a244-dd5d70e974c4",
"provider_id": "f029cc0c-9eb8-41b3-82b1-a9cc26fde03f",
"country_id": "bb67ae67-53d1-4810-be05-33043115399c",
"currency_id": "6b3147f9-aa5b-4fd9-934d-ee5a179db989",
"created_at": "2025-10-30T22:55:55.293Z",
"updated_at": "2025-10-30T22:55:55.387Z",
"customer": {
"first_name": "Ogonnawwwww",
"last_name": "Geeddsss",
"email": "[email protected]",
"phone_number": "2348091222123",
"gender": "Male"
},
"policy": {
"policy_number": "PAC/PP/10/2025/AC/6167"
},
"provider": {
"organization_name": "Sovereign Trust"
},
"distributor": {
"organization_name": "suramogaji enterprise"
},
"product": {
"name": "Mini Comprehensive"
}
},
// ...
]
}
}
Get one purchase or renewal details by ID
GET
https://v2.api.mycover.ai/v2/purchases/:id
Response
200 OK
{
"responseCode": 1,
"responseText": "Purchase retrieved successfully",
"data": {
"id": "50d4ef41-ba21-4309-8b09-8eff0d13886f",
"app_mode": "test",
"is_renewal": false,
"amount": "50000.0000",
"customer_id": "70b33e7f-bbb4-42c2-ad92-29c20ee0e9ab",
"distributor_id": "5a32b459-8c3b-46bc-b699-0c5902824b1b",
"payment_channel": "none",
"payment_option": "wallet",
"policy_id": "507d32df-4b25-462b-ac5a-d26d63468e67",
"product_category_id": "978ced0d-0e05-4de6-b43a-b408c0e8b95e",
"product_id": "0ced01f3-7698-4101-a244-dd5d70e974c4",
"provider_id": "f029cc0c-9eb8-41b3-82b1-a9cc26fde03f",
"country_id": "bb67ae67-53d1-4810-be05-33043115399c",
"currency_id": "6b3147f9-aa5b-4fd9-934d-ee5a179db989",
"created_at": "2025-10-30T22:55:55.293Z",
"updated_at": "2025-10-30T22:55:55.387Z",
"customer": {
"id": "70b33e7f-bbb4-42c2-ad92-29c20ee0e9ab",
"first_name": "Ogonnawwwww",
"last_name": "Geeddsss",
"email": "[email protected]",
"phone_number": "2348091222123",
"gender": "Male",
},
"policy": {
"id": "507d32df-4b25-462b-ac5a-d26d63468e67",
"app_mode": "test",
"is_as_service": false,
"first_name": "Abdullahi",
"last_name": "Jerry",
"email": "[email protected]",
"phone_number": "2348068988777",
"date_of_birth": "2007-01-01T22:54:00.000Z",
"activation_date": "2025-10-30T22:55:55.381Z",
"start_date": "2025-10-30T22:55:55.380Z",
"expiration_date": "2026-10-30T00:00:00.000Z",
"amount": "50000.0000",
"is_active": true,
"is_submitted_to_provider": true,
"customer_id": "70b33e7f-bbb4-42c2-ad92-29c20ee0e9ab",
"insured_id": "2e6a15aa-0ab4-4511-8841-488748032d11",
"insured_policy_relationship": "policy_holder",
"insured_type": "primary_insured",
"distributor_id": "5a32b459-8c3b-46bc-b699-0c5902824b1b",
"provider_id": "f029cc0c-9eb8-41b3-82b1-a9cc26fde03f",
"product_id": "0ced01f3-7698-4101-a244-dd5d70e974c4",
"product_category_id": "978ced0d-0e05-4de6-b43a-b408c0e8b95e",
"country_id": "bb67ae67-53d1-4810-be05-33043115399c",
"currency_id": "6b3147f9-aa5b-4fd9-934d-ee5a179db989",
"purchase_id": "50d4ef41-ba21-4309-8b09-8eff0d13886f",
"policy_number": "PAC/PP/10/2025/AC/6167",
"certificate_url": "https://ss.mycover.ai/#pQFKxrGJpB",
"created_at": "2025-10-30T22:55:55.381Z",
"updated_at": "2025-10-30T22:55:58.269Z",
},
"provider": {
"organization_name": "Sovereign Trust"
},
"distributor": {
"organization_name": "suramogaji enterprise"
},
"product": {
"name": "Mini Comprehensive",
"category": {
"name": "Auto"
}
}
}
}