| Table of Contents |
|---|
Introduction
To obtain the payload of multiple inquiries, belonging to one single broker, the Thinksurance Public API V2, denoted as "the API," offers a specialised endpoint. This endpoint allows consumers to retrieve all relevant inquiry information
Endpoint
To search for a list of inquiries belonging to the specific broker, consumers should send a HTTP POST request to endpoint /api/ipn/get/{:token}. The token parameter represents the security token acquired during the Authentication process on the API (see V1 Authentication). As essential components of the JSON payload within the body of the request, consumers are required to include bToken (functioning as the broker identifier).
Action name | search inquiries |
|---|---|
HTTP path | /api/ipn/get/{:token}
|
HTTP method | POST |
Attributes of the HTTP request
bToken | string | required | An unique identifier of the broker. |
|---|---|---|---|
iId | stringint | optional | An unique identifier of an inquiry. |
lastDays | int | optional | If defined, only inquiries that were created or updated that last number of days, will be included in the result. Otherwise, inquiries created or updated in last three months will be included. |
Attributes of the HTTP response
...
Success response
...
JSON dictionary of key-value pairs. Each key is an unique identifier of an inquiry and value represents a concrete item with all inquiry related data. To understand the item data, check Item Scheme below.
...
Item Scheme
...
sHash
...
string
...
required
...
Security check, if request comes from THINKSURANCE API (see “Security hash generation”)
...
data
...
object
...
required
...
A root object that holds information on inquiry items. Check Inquiry Scheme bellow.
...
customer
...
object
...
optional
...
A root object that holds information on customer items. Check Customer Scheme bellow.
...
docs
...
array
...
optional
...
A root object that holds a list of document metadata items Check Document Scheme bellow.
Inquiry Scheme
...
bToken
...
string
...
required
...
Broker specific token in THINKSURANCE system
...
bExternalId
...
string
...
required
...
Partner’s internal ID for this Broker
...
iId
...
int
...
required
...
Inquiry ID in THINKSURANCE system
...
iCreated
...
string
...
required
...
Date of creation of inquiry
...
iUpdated
...
string
...
required
...
Date of update of inquiry
...
productName
...
string
...
optional
...
A product’s name on Thinksurance System.
...
productId
...
int
...
optional
...
A product’s unique identifier on Thinksurance System.
...
industryId
...
int
...
optional
...
An industry’s unique identifier on Thinksurance System.
...
professionName
...
string
...
optional
...
A profession’s name on Thinksurance System.
...
professionId
...
int
...
optional
...
A profession’s unique identifier on Thinksurance System.
...
status
...
int
...
required
...
Enumeration value that defines the status of an inquiry. Possible values:
2 - tendering (lead)
3 - tendering
4 - calculated
6 - ordered
15 - proposal created
...
employees
...
object
...
optional
...
A root object that contains information on employees in the insured company. Check Employee Scheme bellow.
...
revenue
...
string2
...
optional
...
Revenue given in Thinksurance Risk Assessment questionnaire.
...
bFoundDate
...
string
...
optional
...
Founding date of the broker’s company.
MySQL format for date: {{ YYYY-MM-DD }}
...
taxPercent
...
int
...
optional1
...
Revenue given in Thinksurance Risk Assessment questionnaire.
...
contractStartDate
...
string
...
optional1
...
The starting date of the contract start date.
MySQL format for date: {{ YYYY-MM-DD }}
...
contractPayDate
...
string
...
optional1
...
The contract’s payment date.
MySQL format for date: {{ YYYY-MM-DD }}
...
insuranceCompanyName
...
string
...
optional
...
Insurance company name selected by Customer/Partner
...
insuranceCompanyId
...
int
...
optional
...
Insurance company unique identifier on Thinksurance system.
...
coverage
...
int23
...
optional
...
Coverage amount for specific insurance company.
...
deductible
...
int2
...
optional
...
Deductible for specific insurance company
...
premiumYearly
...
int4
...
optional1
...
Yearly gross premium.
...
contractDuration
...
int
...
optional1
...
Contract period in years.
...
paymentInterval
...
int
...
optional1
...
Enumeration value that defines the payment interval in months. Possible values:
1 - paid monthly
3 - paid quarterly
6 - paid half yearly
12 - paid yearly
Employee Scheme
...
full
...
string
...
optional
...
Number of full time employees given in Thinksurance Risk Assessment questionnaire.
...
part
...
string
...
optional
...
Number of part time employees given in Thinksurance Risk Assessment questionnaire.
Customer Scheme
...
cId
...
int
...
optional
...
A customer unique identifier on Thinksurance System.
...
cExternalId
...
string
...
optional
...
Unique customer’s ID in the partners system.
...
cSalutation
...
int
...
optional
...
Enumeration value that defines salutation of the customer person:
1 - Mr
2 - Ms
...
cFirstName
...
string
...
optional
...
Customer person’s first name.
...
cLastName
...
string
...
optional
...
Customer person’s last name.
...
cBirthDate
...
string
...
optional
...
Customer person’s date of birth.
MySQL format for date: {{ YYYY-MM-DD }}
...
cEmail
...
string
...
optional
...
Customer person’s email address.
...
cStreet
...
string
...
optional
...
Customer person’s street name.
...
cStreetNumber
...
string
...
optional
...
Customer person’s street number.
...
cZip
...
string
...
optional
...
Customer person’s postcode.
...
cCity
...
string
...
optional
...
Customer person’s city.
...
cWebsite
...
string
...
optional
...
Customer person’s website.
...
cPhone
...
string
...
optional
...
Customer person’s phone number.
...
cPrivateIsCompanyAddress
...
int
...
optional
...
Enumeration value that defines if customer person’s address should be used as actual business address for the customer:
0 - no, use address from cCompany section
1 - yes
...
cCompany
...
string
...
optional
...
Customer company’s name.
...
cCompanyStreet
...
string
...
optional
...
Customer business address street name.
...
cCompanyStreetNumber
...
string
...
optional
...
Customer business address street number.
...
cCompanyZip
...
string
...
optional
...
Customer business address postcode.
...
cCompanyCity
...
string
...
optional
...
Customer business address city.
Document Scheme
...
token
...
string
...
optional
...
Token which allows for access to documents per Link
...
expired
...
string
...
optional
...
Expiration date for document token
...
files
...
array
...
optional
...
Object of the document. Every document has it’s own object.
Explanations:
1 It is not provided for inquiries in the status 2, 3, 4.
2 Value represented in EUR.
3 In some cases (specific products like Firmenrechtsschutz) it could be string(“unbegrenzt”).
4 Value represented in CENTS.
...
Failed response
...
error
...
string
...
required
...
It contains a reason for the failed request.
Examples
This section shows examples of different HTTP requests and responses associated with the endpoint.
...
HTTP Request
...
| Code Block |
|---|
# HTTP POST
# https://app.dev.thinksurance.de/api/ipn/get/<some long hash>
#
# HTTP headers
# 'Content-Type': 'application/json'
# 'Accept': 'application/json'
#
{
"bToken": "<some encrypted string>"
} |
...
Successful HTTP Response
...
| language | json |
|---|
...
Examples
This section shows examples of different HTTP requests and responses associated with the endpoint.
HTTP Request with simple payload | |||||
| |||||
HTTP Request with inquiry identifier | |||||
| |||||
HTTP Request with last days specified | |||||
| |||||
Successful HTTP Response | |||||
| |||||
Failed HTTP Response | |||||
|