Download OpenAPI specification:Download
CascoApi documentation
Authenticate an account by account/password
| account required | string Account |
| password required | string Password |
{- "error": "false",
- "status": "200",
- "data": {
- "token": "---JWT Token---",
- "expires_at": "2021-09-03 19:41:27",
- "refresh_token": "---Refresh Token---"
}
}Renew an authentication token
| Token required | string Example: Refresh [refresh_token] The Refresh token received from the |
{- "error": "false",
- "status": "200",
- "data": {
- "token": "---JWT Token---",
- "expires_at": "2021-09-03 19:41:27",
- "refresh_token": "---Refresh Token---"
}
}A quote is obtained from the insurer for the product specified in the request.
| Token required | string <jwt> The JWT token received from the |
JSON format body
required | object (ProviderData) Data object representing a provider |
required | object (ProductData) Data object representing a product |
{- "provider": {
- "organization": {
- "businessName": "groupama"
}, - "authentication": {
- "account": "user123",
- "password": "securePassword123",
- "code": "AUTH456"
}
}, - "product": {
- "name": "casco",
- "motor": {
- "startDate": "2023-01-01",
- "termTime": 12,
- "installmentCount": 1,
- "currency": "RON",
- "renewPolicy": {
- "series": "AB",
- "number": 123456
}, - "mentions": "Additional mentions or notes",
- "withoutTax": "false",
- "deductibles": {
- "partialDamage": 500,
- "totalDamage": 20
}
}, - "coverages": [
- {
- "isIncluded": true,
- "code": "vehicle",
- "insuredSum": 10000.5
}
], - "policyholder": {
- "isLegalEntity": "false",
- "businessName": "TechCorp",
- "companyRegistryNumber": "12345678",
- "caenCode": 6201,
- "lastName": "Doe",
- "firstName": "John",
- "isForeignPerson": false,
- "taxId": "RO123456789",
- "nationality": "RO",
- "citizenship": "RO",
- "gender": "m",
- "birthdate": "1990-01-01",
- "email": "john.doe@example.com",
- "mobileNumber": "0712345678",
- "drivingLicense": {
- "issueDate": "2010-05-15"
}, - "identification": {
- "idType": "CI",
- "idNumber": "AB123456",
- "issueAuthority": "Police Department",
- "issueDate": "2023-01-01"
}, - "address": {
- "country": "RO",
- "county": "Cluj",
- "city": "Cluj-Napoca",
- "cityCode": 12345,
- "street": "Eroilor",
- "houseNumber": "10",
- "building": "A",
- "staircase": "1",
- "apartment": "12",
- "floor": "3",
- "postcode": "400001"
}, - "hasDisability": false,
- "isRetired": false,
- "residency": "resident in Romania",
- "politicalExposure": "no"
}, - "vehicle": {
- "vin": "1HGCM82633A123456",
- "motorSeries": "e2007",
- "vehicleType": "M1",
- "brand": "Toyota",
- "model": "Corolla",
- "yearOfConstruction": 2020,
- "engineDisplacement": 1800,
- "enginePower": 140,
- "totalWeight": 1500,
- "seats": 5,
- "fuelType": "petrol",
- "currentMileage": 120000,
- "color": "white",
- "marketValue": "100000.00",
- "user": {
- "isLegalEntity": "false",
- "businessName": "TechCorp",
- "companyRegistryNumber": "12345678",
- "caenCode": 6201,
- "lastName": "Doe",
- "firstName": "John",
- "isForeignPerson": false,
- "taxId": "RO123456789",
- "nationality": "RO",
- "citizenship": "RO",
- "gender": "m",
- "birthdate": "1990-01-01",
- "email": "john.doe@example.com",
- "mobileNumber": "0712345678",
- "drivingLicense": {
- "issueDate": "2010-05-15"
}, - "identification": {
- "idType": "CI",
- "idNumber": "AB123456",
- "issueAuthority": "Police Department",
- "issueDate": "2023-01-01"
}, - "address": {
- "country": "RO",
- "county": "Cluj",
- "city": "Cluj-Napoca",
- "cityCode": 12345,
- "street": "Eroilor",
- "houseNumber": "10",
- "building": "A",
- "staircase": "1",
- "apartment": "12",
- "floor": "3",
- "postcode": "400001"
}, - "hasDisability": false,
- "isRetired": false,
- "residency": "resident in Romania",
- "politicalExposure": "no"
}, - "identifier": "F9bcVXsC3Zu7PDagZcLfCw==",
- "licensePlate": "B123XYZ",
- "registrationType": "registered",
- "firstRegistration": "2015-06-01",
- "usageType": "personal",
- "identification": {
- "idNumber": "AB123456"
}, - "keyNumber": 3,
- "ptiExpiryDate": "2025-05-12",
- "vignetteExpiryDate": "2025-06-11",
- "hasMobilityModifications": false,
- "isLeased": false,
- "isNew": false,
- "isOwnerTransfer": false
}, - "additionalData": {
- "rafCode": "RAF012345",
- "filterPackages": "false",
- "motor": {
- "contractType": "financial",
- "leasingContractNumber": "RX123456"
}, - "vehicle": {
- "user": {
- "bonusMalusClass": "B0",
- "bonusMalusClaims": "2",
- "noYoungDrivers": "false"
}, - "isAtv": "false",
- "equipmentDescription": "External lighting, Tow bar",
- "equipmentValue": "7000",
- "acquisitionDate": "2023-01-01",
- "isFirstOwner": "false",
- "stolenVehicle": "false",
- "hasConstructionChanges": "false",
- "wheelOnTheRightSide": "false"
}, - "specialAccordCashOnHand": "false",
- "partnerNetworkRepairAgreement": "false",
- "coversMinorChildren": "false",
- "personAccidentsPlan": "SAFE"
}
}
}{- "data": {
- "provider": {
- "organization": {
- "businessName": "groupama"
}
}, - "product": {
- "name": "casco"
}, - "offers": [
- {
- "offerId": 123,
- "providerOfferCode": "ABC123",
- "premiumAmount": 1000.5,
- "currency": "RON",
- "exchangeRate": {
- "currency": "RON",
- "amount": 100.5,
- "exchangeRate": 1.12
}, - "payment": {
- "currency": "RON",
- "amount": 100.5
}, - "startDate": "2025-01-01",
- "endDate": "2025-12-31",
- "installments": [
- {
- "id": 1,
- "amount": 123.45,
- "dueDate": "2025-12-12"
}
], - "coverages": [
- {
- "code": "vehicle",
- "notes": "Coverage insured sum is covered in the main insurance sum."
}
], - "offerExpiryDate": "2025-12-31",
- "notes": "Special conditions apply",
}
]
}
}Download offer in PDF format
| id required | integer Offer identification number |
| Token required | string <jwt> The JWT token received from the |
{- "data": {
- "files": [
- {
- "type": "offer",
- "mimeType": "application/pdf",
- "name": "document.pdf",
- "content": "JVBERi0xLjQKJcfs..."
}
]
}
}Download policy in PDF format
| series required | string Policy identification series |
| number required | integer Policy identification number |
| Token required | string <jwt> The JWT token received from the |
{- "data": {
- "files": [
- {
- "type": "offer",
- "mimeType": "application/pdf",
- "name": "document.pdf",
- "content": "JVBERi0xLjQKJcfs..."
}
]
}
}The offer is transformed into a policy based on the offer identifier.
| Token required | string <jwt> The JWT token received from the |
JSON formatted body
| offerId required | number The unique identifier of the offer |
required | object (PaymentData) Data object representing a payment |
{- "offerId": 12345,
- "payment": {
- "method": "pos",
- "currency": "RON",
- "amount": 100.5,
- "date": "2023-10-01",
- "documentNumber": "INV-12345"
}
}{- "data": {
- "policies": [
- {
- "provider": {
- "organization": {
- "businessName": "groupama"
}
}, - "product": {
- "name": "casco"
}, - "policyId": 123,
- "providerPolicyCode": "POLICY123",
- "series": "A",
- "number": "123456",
- "payment": {
- "method": "pos",
- "currency": "RON",
- "amount": 100.5,
- "date": "2023-10-01",
- "documentNumber": "INV-12345"
}, - "startDate": "2025-01-01",
- "endDate": "2025-12-31",
- "premiumAmount": 1000.5,
- "currency": "RON",
- "installments": [
- {
- "id": 1,
- "amount": 123.45,
- "dueDate": "2025-12-12"
}
], - "coverages": [
- {
- "code": "vehicle",
- "notes": "Coverage insured sum is covered in the main insurance sum."
}
], - "notes": "Policy notes"
}
]
}
}| Token required | string <jwt> The JWT token received from the |
{- "data": [
- {
- "id": "1",
- "name": "GRECIA",
- "iso2": "GR",
- "iso3": "GRC"
}
]
}| Token required | string <jwt> The JWT token received from the |
{- "data": [
- {
- "county_code": "CJ",
- "name": "CLUJ",
- "siruta": "127"
}
]
}| county_code required | integer County code |
| Token required | string <jwt> The JWT token received from the |
{- "error": "false",
- "status": "200",
- "data": [
- {
- "nume": "CLUJ-NAPOCA",
- "cod_judet": "CJ",
- "cod_siruta": "54984"
}
]
}| Token required | string <jwt> The JWT token received from the |
{- "data": [
- {
- "name": "alfa-romeo"
}
]
}| make required | string Vehicle make name |
| Token required | string <jwt> The JWT token received from the |
{- "data": [
- {
- "name": "750"
}
]
}Identify a vehicles identification code based on it's mechanical data.
| Token required | string <jwt> The JWT token received from the |
JSON format body
| vin | string Vehicle Identification Number (VIN) |
| motorSeries | string Vehicle motor series (if applicable) |
| vehicleType required | string (VehicleTypeEnum) Enum: "M1" "M1G" "M2" "M2G" "M3" "M3G" "N1" "N1G" "N2" "N2G" "N3" "N3G" "O1" "O2" "O3" "O4" "L1e" "L2e" "L3e" "L4e" "L5e" "L6e" "L7e" "T" "C" "R" "S" Enum representing vehicle types |
| brand required | string Brand of the vehicle |
| model required | string Model of the vehicle |
| yearOfConstruction required | integer Year the vehicle was constructed
|
| engineDisplacement | integer Engine displacement in cubic centimeters
|
| enginePower | integer Engine power (kW)
|
| totalWeight | integer Total weight of the vehicle in kilograms |
| seats | integer Number of seats in the vehicle
|
| fuelType | string (FuelTypeEnum) Enum: "petrol" "diesel" "electric" "hybrid" "lpg" "none" Enum representing fuel types for vehicles |
| currentMileage | integer Current mileage of the vehicle in kilometers |
| color | string (ColorEnum) Enum: "white" "blue" "yellow" "gray" "brown" "black" "orange" "red" "green" "purple" Enum representing colors for vehicles |
| marketValue | number <float> Market value of the vehicle |
{- "vin": "1HGCM82633A123456",
- "motorSeries": "e2007",
- "vehicleType": "M1",
- "brand": "Toyota",
- "model": "Corolla",
- "yearOfConstruction": 2020,
- "engineDisplacement": 1800,
- "enginePower": 140,
- "totalWeight": 1500,
- "seats": 5,
- "fuelType": "petrol",
- "currentMileage": 120000,
- "color": "white",
- "marketValue": "100000.00"
}{- "data": {
- "INSURER_NAME": [
- {
- "identifier": "F9bcVXsC3Zu7PDagZcLfCw==",
- "modelName": "Civic 1.5 VTEC Turbo CVT Prestige",
- "productionStartDate": "2017-03",
- "productionEndDate": "2021-01",
- "marketValue": 26500,
- "additionalData": { }
}
]
}
}