Pohjola Motor Insurance API (2.0.0)
Download OpenAPI specification:Download
Pohjola Motor Insurance API allows Pohjola's insurance agents like car dealerships to quickly calculate personalized motor insurance prices for their customers and help them purchase the insurance directly. It's an easy way for our partners to offer tailored insurance solutions, all in one seamless process.
Purchase insurance
Purchase of vehicle insurance
Authorizations:
header Parameters
| x-request-id required | string <uuid> Example: 7dc53df5-123e-49b3-8670-b1c468f47f1f Unique identifier (UUID) for a specific request/request flow through the whole system/software stack. |
| x-session-id required | string <uuid> Example: 7dc53df5-123e-49b3-8670-b1c468f47f1f Identifier for a conceptual client/user session (not necessarily corresponding to an HTTP session), stays constant over several client-side requests. Session id is generated (UUID) and provided by the API consumer. |
| Accept-Language | string Language of the user. An ISO-639 language code (lowercase) and optionally an ISO-3166 country code (uppercase), separated with a hyphen (-). If the header is not provided, the locale will default to 'fi-FI'. |
Request Body schema: application/jsonrequired
| authenticationTime required | string <date-time> Authentication time (fi. Tunnistautumisaika) |
| deductibleAmount required | integer <int32> Deductible (fi. Omavastuu) |
| policyHolderSsn required | string Policy holder (fi. Vakuutuksenottaja) |
| referenceId required | string Quote reference id |
| stronglyAuthenticated required | boolean Strongly authenticated (fi. Vahvasti tunnistautunut) |
| vehicleOwnerSsn | string Vehicle owner - private (fi. Ajoneuvon omistaja - yksityinen) |
| vehicleOwnerCorporateId | string Vehicle owner – corporate (fi. Ajoneuvon omistaja - yritys) |
| vehicleHolderSsn | string Vehicle holder (fi. Ajoneuvon haltija) |
| mobileNumber | string Mobile number (fi. Matkapuhelinnumero) |
| emailAddress | string Email address (fi. Sähköpostiosoite) |
| totalPrice | number Total price (fi. Kokonaishinta) |
Responses
Request samples
- Payload
- CURL
{- "referenceId": "string",
- "deductibleAmount": 0,
- "policyHolderSsn": "string",
- "vehicleOwnerSsn": "string",
- "vehicleOwnerCorporateId": "string",
- "vehicleHolderSsn": "string",
- "mobileNumber": "string",
- "emailAddress": "string",
- "totalPrice": 0,
- "stronglyAuthenticated": true,
- "authenticationTime": "2019-08-24T14:15:22Z"
}Response samples
- 200
- 404
{- "message": "string",
- "status": "string"
}Calculate vehicle insurance offering
Retrieval of vehicle insurance offer
Authorizations:
header Parameters
| x-request-id required | string <uuid> Example: 7dc53df5-123e-49b3-8670-b1c468f47f1f Unique identifier (UUID) for a specific request/request flow through the whole system/software stack. |
| x-session-id required | string <uuid> Example: 7dc53df5-123e-49b3-8670-b1c468f47f1f Identifier for a conceptual client/user session (not necessarily corresponding to an HTTP session), stays constant over several client-side requests. Session id is generated (UUID) and provided by the API consumer. |
| Accept-Language | string Language of the user. An ISO-639 language code (lowercase) and optionally an ISO-3166 country code (uppercase), separated with a hyphen (-). If the header is not provided, the locale will default to 'fi-FI'. |
Request Body schema: application/jsonrequired
| insuranceAndClaimHistoryQueryAllowed required | boolean Insurance and claim history query approved |
| paymentFrequency required | integer <int32> How many instalments per year? |
required | object (PolicyHolder) PolicyHolder (fi. Vakuutuksenottaja) |
required | object (Vehicle) Vehicle (fi. Ajoneuvo) |
| recommendedInsuranceOnly | boolean Show recommended insurance only |
| language | string Enum: "FI" "SV" Language for the offering |
Responses
Request samples
- Payload
- CURL
{- "insuranceAndClaimHistoryQueryAllowed": true,
- "recommendedInsuranceOnly": true,
- "language": "FI",
- "policyHolder": {
- "ssn": "string",
- "streetAddress": "string",
- "postalCode": "string",
- "municipalityCode": "string"
}, - "vehicle": {
- "registrationNumber": "string",
- "vehicleIdentificationNumber": "string",
- "vehicleType": "CAR",
- "alarmDevice": true,
- "ownedByFinancialCompany": true,
- "kilometersPerYear": 0,
- "marketValue": 0
}, - "paymentFrequency": 0
}Response samples
- 200
- 404
{- "referenceId": "string",
- "insurancePackages": [
- {
- "name": "string",
- "description": "string",
- "recommended": true,
- "trafficInsurance": {
- "price": {
- "amount": 0,
- "currencyCode": "string"
}, - "name": "string",
- "code": "string",
- "bonusturvaIncluded": true,
- "bonusturvaDescription": "string"
}, - "voluntaryInsurance": {
- "price": {
- "amount": 0,
- "currencyCode": "string"
}, - "name": "string",
- "code": "string"
}, - "price": {
- "amount": 0,
- "currencyCode": "string"
}, - "bonus": {
- "trafficBonusPercentage": 0,
- "kaskoBonusPercentage": 0
}, - "discounts": [
- {
- "name": "string",
- "price": {
- "amount": 0,
- "currencyCode": "string"
}, - "code": "string"
}
], - "documents": [
- {
- "name": "string",
- "url": "string"
}
], - "coverages": [
- {
- "name": "string",
- "description": "string",
- "optional": true,
- "selected": true,
- "price": {
- "amount": 0,
- "currencyCode": "string"
}, - "indemnity": {
- "indemnityDays": 0,
- "indemnityAmt": {
- "amount": 0,
- "currencyCode": "string"
}, - "text": "string"
}, - "deductible": {
- "price": {
- "amount": 0,
- "currencyCode": "string"
}, - "description": "string",
- "selected": true,
- "bonusEntitled": true
}
}
]
}
]
}