Introduction

To retrieve a list of supported professions on the Platform, the Thinksurance Public API V1 (referred to as "the API") provides a dedicated endpoint designed specifically for this purpose. This endpoint enables consumers to retrieve the complete list of professions used to map all business to them.

Endpoint

To retrieve professions, consumers are required to send an HTTP GET POST request to the /api/ipn/professions endpoint. This endpoint requires the security token, obtained during the Authentication process on the API, as an integral component of the JSON payload within the body of the request.

Attributes of the HTTP request

Attributes of the HTTP response

Examples

This section shows examples of different HTTP requests and responses associated with the endpoint /api/ipn/professions.

# HTTP GETPOST
# https://ipnapp.dev.thinksurance.de/api/ipn/professions
# # HTTP headers'Content-Type': 'application/json'
# 'Accept': 'application/json'
{
# 'Authorization'  "token": 'Bearer "<some long string value>'
# hash>"
}

# HTTP 200 status code
# 'Content-Type': 'application/json'
[
  {
    "id": 1,
    "name": "Profession1"
  },
  {
    "id": 2,
    "name": "Profession2"
  }
]

# HTTP 200 status code
# 'Content-Type': 'application/json'
{
  "error": "API User is not existing or deactivated."
}