Download OpenAPI specification:Download
RotrApi documentation
Changelog
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---"
}
}Generate an offer based on the input fields
| Token required | string |
JSON format body
required | object |
required | object |
object (Agreements) |
{- "provider": {
- "organization": {
- "businessName": "PROVIDER_NAME"
}, - "authentication": {
- "account": "123456",
- "password": "123cuidd#",
- "code": "ICJ1345"
}
}, - "product": {
- "name": "PRODUCT_NAME",
- "currency": "RON",
- "transport": {
- "startDate": "2023-05-25",
- "termTime": "12",
- "installmentCount": "1",
- "sumInsured": "27000",
- "numberOfVehicles": "1",
- "mentions": "Registration number: CJ59LIH",
- "discount": "0"
}, - "customer": {
- "businessName": "Life is Hard",
- "companyRegistryNumber": "J12/1403/2004",
- "lastName": "Pop",
- "firstName": "Vasile",
- "isForeignPerson": "false",
- "taxId": "1910716000000",
- "nationality": "RO",
- "citizenship": "RO",
- "gender": "m",
- "birthdate": "2021-01-01",
- "email": "email@email.ro",
- "mobileNumber": "0744444444",
- "identification": {
- "idType": "CI",
- "idNumber": "CJ123456",
- "issueAuthority": "SPCLEP Cluj",
- "issueDate": "2022-11-24"
}, - "address": {
- "country": "RO",
- "county": "CJ",
- "city": "Cluj-Napoca",
- "cityCode": "54984",
- "street": "Principala",
- "houseNumber": "19-21",
- "building": "A1",
- "staircase": "1",
- "apartment": "12",
- "floor": "3",
- "postcode": "400356"
}, - "correspondenceAddress": {
- "country": "RO",
- "county": "CJ",
- "city": "Cluj-Napoca",
- "cityCode": "54984",
- "street": "Principala",
- "houseNumber": "19-21",
- "building": "A1",
- "staircase": "1",
- "apartment": "12",
- "floor": "3",
- "postcode": "400356"
}
}, - "policyholder": {
- "businessName": "Life is Hard",
- "companyRegistryNumber": "J12/1403/2004",
- "lastName": "Pop",
- "firstName": "Vasile",
- "isForeignPerson": "false",
- "taxId": "1910716000000",
- "nationality": "RO",
- "citizenship": "RO",
- "gender": "m",
- "birthdate": "2021-01-01",
- "email": "email@email.ro",
- "mobileNumber": "0744444444",
- "identification": {
- "idType": "CI",
- "idNumber": "CJ123456",
- "issueAuthority": "SPCLEP Cluj",
- "issueDate": "2022-11-24"
}, - "address": {
- "country": "RO",
- "county": "CJ",
- "city": "Cluj-Napoca",
- "cityCode": "54984",
- "street": "Principala",
- "houseNumber": "19-21",
- "building": "A1",
- "staircase": "1",
- "apartment": "12",
- "floor": "3",
- "postcode": "400356"
}, - "correspondenceAddress": {
- "country": "RO",
- "county": "CJ",
- "city": "Cluj-Napoca",
- "cityCode": "54984",
- "street": "Principala",
- "houseNumber": "19-21",
- "building": "A1",
- "staircase": "1",
- "apartment": "12",
- "floor": "3",
- "postcode": "400356"
}
}, - "additionalData": {
- "product": {
- "transport": {
- "sumInsuredRRA": "1500"
}
}
}
}, - "agreements": {
- "gdpr": "true",
- "marketing": "true"
}
}{- "data": {
- "provider": {
- "organization": {
- "businessName": "PROVIDER_NAME"
}
}, - "product": {
- "name": "PRODUCT_NAME"
}, - "offer": {
- "offerId": "12",
- "premiumAmount": "89.76",
- "currency": "RON",
- "premiumRates": [
- {
- "id": "1",
- "currency": "EUR",
- "amount": "23.16",
- "exchangeRate": "4.9219"
}
], - "installments": [
- {
- "id": "1",
- "currency": "EUR",
- "amount": "23.16",
- "dueDate": "2024-05-01"
}
], - "payment": {
- "amount": "89.76",
- "currency": "RON"
}, - "startDate": "2022-09-25",
- "endDate": "2023-09-24",
- "notes": "string",
- "providerResponse": { }
}
}
}Retrive offer PDF file
| id required | integer Offer identification number |
| Token required | string |
{- "data": {
- "files": [
- {
- "type": "Offer",
- "name": "offer-2149be26-d38d-40e4-ad07-1ccb384aadec.pdf",
- "content": "JVBERi0xLj..."
}
]
}
}Retrieve offer status by ID
| id required | integer Offer identification number |
| Token required | string |
{- "data": {
- "provider": {
- "organization": {
- "businessName": "PROVIDER_NAME"
}
}, - "product": {
- "name": "PRODUCT_NAME"
}, - "offerNumber": "ROT110104",
- "offerStatus": "initialized",
- "insuredName": "STANTON, DENESIK AND LESCH",
- "offerCreationDate": "2024-04-18",
- "insuredAmount": "1000",
- "premiumAmount": "35",
- "currency": "EUR",
- "startDate": "2024-05-01",
- "endDate": "2025-04-30"
}
}Retrieve policy PDF file
| series required | string Example: series=ROT Policy series |
| number required | string Example: number=1234567890 Policy number |
| Token required | string |
{- "data": {
- "files": [
- {
- "type": "Offer",
- "name": "offer-2149be26-d38d-40e4-ad07-1ccb384aadec.pdf",
- "content": "JVBERi0xLj..."
}
]
}
}Issuing a selected offer
| Token required | string |
JSON formatted body
| offerId required | integer |
required | object (Payment) |
object (Person) |
{- "offerId": "23",
- "payment": {
- "method": "receipt",
- "currency": "RON",
- "amount": "89.76",
- "date": "2022-09-21",
- "documentNumber": "XY32344"
}, - "payer": {
- "businessName": "Life is Hard",
- "companyRegistryNumber": "J12/1403/2004",
- "lastName": "Pop",
- "firstName": "Vasile",
- "isForeignPerson": "false",
- "taxId": "1910716000000",
- "nationality": "RO",
- "citizenship": "RO",
- "gender": "m",
- "birthdate": "2021-01-01",
- "email": "email@email.ro",
- "mobileNumber": "0744444444",
- "identification": {
- "idType": "CI",
- "idNumber": "CJ123456",
- "issueAuthority": "SPCLEP Cluj",
- "issueDate": "2022-11-24"
}, - "address": {
- "country": "RO",
- "county": "CJ",
- "city": "Cluj-Napoca",
- "cityCode": "54984",
- "street": "Principala",
- "houseNumber": "19-21",
- "building": "A1",
- "staircase": "1",
- "apartment": "12",
- "floor": "3",
- "postcode": "400356"
}, - "correspondenceAddress": {
- "country": "RO",
- "county": "CJ",
- "city": "Cluj-Napoca",
- "cityCode": "54984",
- "street": "Principala",
- "houseNumber": "19-21",
- "building": "A1",
- "staircase": "1",
- "apartment": "12",
- "floor": "3",
- "postcode": "400356"
}
}
}{- "data": {
- "policies": [
- {
- "provider": {
- "organization": {
- "businessName": "PROVIDER_NAME"
}
}, - "product": {
- "name": "PRODUCT_NAME"
}, - "policyId": "12",
- "series": "RSXX",
- "number": "13124",
- "payment": {
- "method": "receipt",
- "currency": "RON",
- "amount": "89.76",
- "date": "2022-09-21",
- "documentNumber": "XY32344"
}, - "startDate": "2022-09-25",
- "endDate": "2023-09-24",
- "premiumAmount": "89.76",
- "currency": "RON",
- "installments": [
- {
- "id": "1",
- "currency": "EUR",
- "amount": "23.16",
- "dueDate": "2024-05-01"
}
], - "providerResponse": { }
}
]
}
}Retrieve policy PDF file
| id required | integer Policy identification number |
| Token required | string |
{- "data": {
- "files": [
- {
- "type": "Offer",
- "name": "offer-2149be26-d38d-40e4-ad07-1ccb384aadec.pdf",
- "content": "JVBERi0xLj..."
}
]
}
}If an offer is pending (it needs to be approved, it needs to be confirmed or it is active) then this endpoint returns informations about it
| Token required | string |
JSON format body
required | object |
| ean13 required | number ean13 code of the offer from the provider's offer response |
{- "provider": {
- "authentication": {
- "account": "123456",
- "password": "123cuidd#",
- "code": "ICJ1345"
}
}, - "ean13": "3876866826729"
}{- "data": {
- "offerNumber": "ROT100345",
- "ean13": "3876866826729",
- "offerStatus": "ACTIVE",
- "insured": "Test Test",
- "issuedBy": "Camscape Test test@camscape.ro",
- "agency": "SUCURSALA CENTRALA",
- "startDate": "2023-06-13",
- "endDate": "2024-06-12",
- "issuedAt": "2023-06-12T03:20:58+03:00",
- "sumInsured": "10000",
- "premiumAmount": "95",
- "currency": "EUR",
- "premiumAmountRon": "469.96"
}
}