Create Policy

post

https://api-staging.qoala.app/api/v2/quotation/quotes

This API is used by partner to create policy

Body Params

The following list explains body payload for creating policy

product_category

string

enum

required

Defaults to GADGET

product classification will be provided by Qoala

Allowed:

partner_transaction_number

string

required

length ≤ 100

Defaults to Tx12345678543213456

The Transaction ID serves as a unique identifier for each transaction initiated through the API. Partners are responsible for generating this ID and ensuring its uniqueness across their transactions.

product_code

string

required

Defaults to G-ADLD-VIVO-001

Defined by Qoala, plays a pivotal role in the API, providing contextual information about certain aspects of the product. However, as of now, the details for this field will be shared at a later stage when the product is ready for testing.

purchased_at

date-time

Defaults to 2025-10-04T00:00:00+08:00

A timestamp indicating when a product was purchased. This field is of the time type and is not mandatory. By default, if no value is provided, it is set to the current time. The timestamp is formatted using the ISO 8601 date format.

premium

number

A vital component of the API, representing the cost of an insurance product in its respective currency.

policy_holder

object

required

The policy_holder field serves as a container for essential data regarding the holder of the policy. This data provides insight into the individual or organization that is associated with the policy.

insureds

array of objects

required

Insured's object. The object can be different depending on the product. For example: covered user, car, smartphone, flight, hotel, etc.

insureds*

Responses

200Success

202Accepted

400Bad Request

401Unauthorized

404Not Found

500Internal Error