Create Quotation

post /insurance/motor/v5/quotations

This endpoint to get quote and create quotation.

Request Header

Name	Type	Required	Description
authorization	string	Required	Bearer token
content-type	string	Required	application/json

Request Body

Name Type Required Description

trans_no

string

Required

Unique string that the client can create to track the current request call.

Min length: 10

Max length: 30

sale_channel

string

Required

Sales channel code to collect transactions.

agent_code string Required Intermediary code

staff_code string Required Staff code that takes care of that sales channel. Provided by AXA

client_type

string

Required

Client Type

C : Corporate
P : Personal

first_name

string

Conditional

Contact person's first name.

Max length: 30

Condition: This field is required when client_type is "P"

last_name

string

Conditional

Contact person's last name.

Max length: 30

Condition: This field is required when client_type is "P"

corporate_name1

string

Conditional

Max length: 60

Condition: This field is required when client_type is "C"

corporate_name2

string

Conditional

Max length: 60

Condition: This field is required when client_type is "C"

phone_number

string

Optional

Contact person's phone number.

Max length: 50

string

Optional

Contact person's email to receive offers.

Max length: 100

promo

string

Optional

Max length: 10

is_red bool Required Use for car red plate

reg_no

string

Conditional

Vehicle license plate

Condition: This field is required when "is_red" is "false"

reg_no_province_code

string

Required

Vehicle license plate(province)

Refer to License Plate Province

vehicle_key string Required Unique Vehicle Key Provided by AXA

use_of_vehicle

string

Conditional

Vehicle use

PrivateUse
CommercialUse

Condition: This field is required when the policy_type in the items is voluntary.

transaction_by guid Required Globally unique identifier value of the user id. Provided by AXA

items array[object] Required Array of Item

drivers

array[object]

Conditional

Array of Drivers
This applies only to the policy type voluntary and following below condition details.
The driver is at least 18 years old but not over 100 years old.

Condition:Policy start date between 01/06/2025 to 31/12/2025

package	use of vehicle	registration type	Car Age	Condition
[EV] Type1, Type2Puls, Type3Plus	Private Use	RY.1, RY.2	All car age	Required Max: 5 drivers
[NON EV] Type1, Type2Puls, Type3Plus	Private Use	RY.1, RY.2	1 year(s)	Required Max: 5 drivers
[NON EV] Type1, Type2Puls, Type3Plus	Private Use	RY.1, RY.2	> 1 year(s)	Optional Max: 2 drivers
[EV] Type1, Type2Puls, Type3Plus	Commercial Use	All registration types	All car age	Not Required
[NON EV] Type1, Type2Puls, Type3Plus	Private Use	RY.3	All car age	Not Required
[NON EV] Type1, Type2Puls, Type3Plus	Commercial Use	All registration types	All car age	Not Required

Condition:Policy start date after 31/12/2025

package	use of vehicle	registration type	Car Age	Condition
[EV] Type1, Type2Puls, Type3Plus	Private Use	RY.1, RY.2	All car age	Required Max: 5 drivers
[NON EV] Type1, Type2Puls, Type3Plus	Private Use	RY.1, RY.2	All car age	Required Max: 5 drivers
[EV] Type1, Type2Puls, Type3Plus	Commercial Use	All registration types	All car age	Not Required
[NON EV] Type1, Type2Puls, Type3Plus	Private Use	RY.3	All car age	Not Required
[NON EV] Type1, Type2Puls, Type3Plus	Commercial Use	All registration types	All car age	Not Required

*** registration type ***

1 : Private passenger car not more than 7 seats (RY.1)
2 : Private passenger car more than 7 seats (RY.2)
3 : Private truck/pickup (RY.3)

Example request : voluntary

{
    "trans_no": "AXA-2110-0001",
    "sale_channel": "BKO",
    "agent_code": "XXXXX",
    "staff_code": "HG",
    "client_type": "P",
    "first_name": "Test",
    "last_name": "System",
    "phone_number": "0999999999",
    "email": "example@axa.co.th",
    "reg_no": "9กก 8888",
    "reg_no_province_code": "10",
    "vehicle_key": "FORD13BNS",
    "use_of_vehicle": "privateuse",
    "drivers": [
        {
            "date_of_birth": "1985-09-12",
            "id_card": "xOiJdhw65",
            "license": "87654321"
        },
        {
            "date_of_birth": "1990-04-26",
            "id_card": "PX7Y23DD",
            "license": "12345678"
        }
    ],
    "items": [
        {
            "policy_type": "voluntary",
            "package_key": "Type2PLuS",
            "garage": "contract",
            "inception_date": "2022-07-06",
            "expiry_date": "2023-07-06",
            "sum_insured": 100000,
            "natcat_code":"",
            "deduct": 0,
            "cctv":true
        }
  ],
    "transaction_by": "8C890CB2-9FAD-4953-BCC7-E54B9ACE827C"
}

Example request : compulsory (full)

{
    "trans_no": "AXA-2110-0001",
    "sale_channel": "BKO",
    "agent_code": "XXXXX",
    "staff_code": "HG",
    "client_type": "P",
    "first_name": "Test",
    "last_name": "System",
    "phone_number": "0999999999",
    "email": "example@axa.co.th",
    "reg_no": "9กก 8888",
    "reg_no_province_code": "10",
    "vehicle_key": "EB1061",
    "use_of_vehicle": "privateuse",
    "items": [
        {
            "policy_type": "compulsory",
            "package_key": "compulsory",
            "inception_date": "2022-07-06",
            "expiry_date": "2023-07-06",
            "year": 2021
        }
  ],
    "transaction_by": "8C890CB2-9FAD-4953-BCC7-E54B9ACE827C"
}

Example request : compulsory (term)

{
    "trans_no": "AXA-2110-0001",
    "sale_channel": "BKO",
    "agent_code": "XXXXX",
    "staff_code": "HG",
    "client_type": "P",
    "first_name": "Test",
    "last_name": "System",
    "phone_number": "0999999999",
    "email": "example@axa.co.th",
    "reg_no": "9กก 8888",
    "reg_no_province_code": "10",
    "vehicle_key": "EB1061",
    "use_of_vehicle": "privateuse",
    "items": [
        {
            "policy_type": "compulsory",
            "package_key": "compulsory",
            "inception_date": "2025-06-01",
            "expiry_date": "2026-03-05",
            "tax_expiry_date": "2026-03-05",
            "year": 2021
        }
  ],
    "transaction_by": "8C890CB2-9FAD-4953-BCC7-E54B9ACE827C"
}

Example request : compulsory (more than 1 year)

{
    "trans_no": "AXA-2110-0001",
    "sale_channel": "BKO",
    "agent_code": "XXXXX",
    "staff_code": "HG",
    "client_type": "P",
    "first_name": "Test",
    "last_name": "System",
    "phone_number": "0999999999",
    "email": "example@axa.co.th",
    "reg_no": "9กก 8888",
    "reg_no_province_code": "10",
    "vehicle_key": "EB1061",
    "use_of_vehicle": "privateuse",
    "items": [
        {
            "policy_type": "compulsory",
            "package_key": "compulsory",
            "inception_date": "2025-06-01",
            "expiry_date": "2026-09-15",
            "tax_expiry_date": "2026-09-15",
            "year": 2021
        }
  ],
    "transaction_by": "8C890CB2-9FAD-4953-BCC7-E54B9ACE827C"
}

Example request : voluntary + compulsory

{
    "trans_no": "AXA-2110-0001",
    "sale_channel": "BKO",
    "agent_code": "XXXXX",
    "staff_code": "HG",
    "client_type": "P",
    "first_name": "Test",
    "last_name": "System",
    "phone_number": "0999999999",
    "email": "example@axa.co.th",
    "reg_no": "9กก 8888",
    "reg_no_province_code": "10",
    "vehicle_key": "FORD13BNS",
    "use_of_vehicle": "privateuse",
    "drivers": [
        {
            "date_of_birth": "1985-09-12",
            "id_card": "xOiJdhw65",
            "license": "87654321"
        },
        {
            "date_of_birth": "1990-04-26",
            "id_card": "PX7Y23DD",
            "license": "12345678"
        }
    ],
    "items": [
        {
            "policy_type": "voluntary",
            "package_key": "Type2PLuS",
            "garage": "contract",
            "inception_date": "2022-07-06",
            "expiry_date": "2023-07-06",
            "sum_insured": 100000,
            "natcat_code":"",
            "deduct": 0,
            "cctv":true
        },
        {
            "policy_type": "compulsory",
            "package_key": "compulsory",
            "reg_no_province_code": "10",
            "inception_date": "2022-07-06",
            "expiry_date": "2023-07-06"
        }
  ],
    "transaction_by": "8C890CB2-9FAD-4953-BCC7-E54B9ACE827C"
}

Response

Name	Type	Description
trans_no	string	Unique string the client made the request
quotation_id	guid	Quotation id is used for issuing the policy
quotation_no	string	Quotation number
valid_date	date	Valid date for applying the policy Format: yyyy-mm-dd
status	string	Quotation status Pending : waiting for use Issued : used already
net_premium	decimal(18,2)	Net premium
discount	decimal(18,2)	Discount value
stamp	int	Stamp duty
vat	decimal(18,2)	VAT is an indirect tax imposed on the value added of each stage of production and distribution.
total_premium	decimal(18,2)	Single Premium or the sum of all Limited Premiums/Regular Premiums paid till date
download	object	Detailed of json object for downloading quotations

Example response

{
    "trans_no": "AXA-2110-0001",
    "quotation_id": "7e94d37c-8712-4c6e-3331-08d993586eae",
    "quotation_no": "QU21002044",
    "valid_date": "2021-11-19",
    "status": "Pending",
    "net_premium": 348.49,
    "discount": 0.00,
    "stamp": 2,
    "vat": 24.53,
    "total_premium": 375.02,
    "download": {
        "type": "quotation",
        "link": "https://uatapiconnect.axa.co.th/report/41ed024e539f44559277aa754293d907"
    }
}

Item Reference

Name	Type	Required	Description
policy_type	string	Required	Type of policy Compulsory Voluntary
package_key	string	Required	Package key Provided by AXA
garage	string	Conditional	Garage Type Contract Dealer `Condition:` This field is required when policy_type is voluntary and package_key are "type1","type2plus", "type3plus"
inception_date	date	Required	Policy effective date Format: yyyy-mm-dd
expiry_date	date	Required	Policy expiration date Format: yyyy-mm-dd
sum_insured	int	Conditional	The sum insured under a motor insurance policy `Condition:` This field is required when policy_type is voluntary and package_key are "type1","type2plus", "type3plus"
natcat_code	string	Optional	Natcat code Provided by AXA `Condition:` Effective only when policy_type is voluntary and package_key are "type2plus", "type3plus"
deduct	int	Optional	The maximum amount you will be required to pay for your car repair in case of damage to your vehicle only when you are at fault or without an identified responsible third party. Condition: if policy_type is "voluntary" and package_key is "type1" then deduct can be 0, 3000 or 5000 if policy_type is "voluntary" and package_key is "type2plus" or, "type3plus" the deduct can be 0 or 2000 `Condition:` Effective only when policy_type is voluntary and package_key are "type1","type2plus", "type3plus"
cctv	bool	Optional	A flag for vehicles with CCTV or dashcam
tax_expiry_date	date	Conditional	Tax expiration date `Condition:` This field is required when policy_type is compulsory and not full year coverage
year	int	Conditional	Manufacture Year e.g. 2021 `Condition:` This field is required for standalone compulsory

Driver Reference

Name Type Required Description

date_of_birth

date

Required

Driver's date of birth

Format: yyyy-mm-dd

Condition: The driver is at least 18 years old but not over 100 years old.

id_card

string

Conditional

Passport No/ Citizen ID

Condition:Policy start date between 01/06/2025 to 31/12/2025

package	use of vehicle	registration type	Car Age	Condition
[EV] Type1, Type2Puls, Type3Plus	Private Use	RY.1, RY.2	All car age	Required
[NON EV] Type1, Type2Puls, Type3Plus	Private Use	RY.1, RY.2	1 year(s)	Required

Condition:Policy start date after 31/12/2025

package	use of vehicle	registration type	Car Age	Condition
[EV] Type1, Type2Puls, Type3Plus	Private Use	RY.1, RY.2	All car age	Required
[NON EV] Type1, Type2Puls, Type3Plus	Private Use	RY.1, RY.2	All car age	Required

*** registration type ***

1 : Private passenger car not more than 7 seats (RY.1)
2 : Private passenger car more than 7 seats (RY.2)
3 : Private truck/pickup (RY.3)

license

string

Conditional

Car driving licence number

Condition:Policy start date between 01/06/2025 to 31/12/2025

package	use of vehicle	registration type	Car Age	Condition
[EV] Type1, Type2Puls, Type3Plus	Private Use	RY.1, RY.2	All car age	Required
[NON EV] Type1, Type2Puls, Type3Plus	Private Use	RY.1, RY.2	1 year(s)	Required

Condition:Policy start date after 31/12/2025

package	use of vehicle	registration type	Car Age	Condition
[EV] Type1, Type2Puls, Type3Plus	Private Use	RY.1, RY.2	All car age	Required
[NON EV] Type1, Type2Puls, Type3Plus	Private Use	RY.1, RY.2	All car age	Required

*** registration type ***

1 : Private passenger car not more than 7 seats (RY.1)
2 : Private passenger car more than 7 seats (RY.2)
3 : Private truck/pickup (RY.3)

V5

Request Header

Request Body

Example request : voluntary

Example request : compulsory (full)

Example request : compulsory (term)

Example request : compulsory (more than 1 year)

Example request : voluntary + compulsory

Response

Example response

Item Reference

Driver Reference