Endpoints

Data formats

There are currently 3 data formats for response data:

• JSON
• XML
• HTML

Format as HTTP header

To request the wished response data format, it is possible to use the Accept header.

Accept: application/json

Accept: application/xml

Accept: text/html

Format as query parameter

As an alternativ it is possible to use a query param

http://api.hansainvest.com/api/v1/endpoint/?format=json

http://api.hansainvest.com/api/v1/endpoint/?format=xml

http://api.hansainvest.com/api/v1/endpoint/?format=html

Data languages

There are currently 2 languages for response data:

• de: German
• en: English

Language as HTTP header

To request the wished response language, it is possible to use the Accept-Language header.

Accept-Language: de

Accept-Language: en

Language as query parameter

As an alternativ it is possible to use a query param

http://api.hansainvest.com/api/v1/endpoint/?language=de

http://api.hansainvest.com/api/v1/endpoint/?language=en

Authentication

Fund data may be protected and then require authentication. It is implemented as Basic access authentication, so the API endpoints should only be accessed through server-side requests. If you would like to use authentication (e.g. as a fund owner), please feel free to contact our support team.

If you want to use authentication (e.g. as owner of a fund) feel free to contact our support team.

API credentials as HTTP header

To request possible to use the Authorization header. The hash is a BASE64 encoded string of:

username + : + password

Authorization: Basic <HASH>

Basic fund data

All funds specific endpoints return some basic fund information for the chosen fund:

See the following examples for data types JSON and XML.

Example return (JSON)

{
    "fund": {
        "name": "3ik-Strategiefonds I Class I",
        "isin": "DE000A1H44G8",
        "wkn": "A1H44G",
        "fund_inception_date": "2011-12-01",
        "status_date": "2023-03-16",
        "url": "https://fondswelt.hansainvest.com/de/fonds/details/151"
    }
}

Example return (XML)

<?xml version="1.0"?>
<root>
  <fund>
    <name>3ik-Strategiefonds I Class I</name>
    <isin>DE000A1H44G8</isin>
    <wkn>A1H44G</wkn>
    <fund_inception_date>2011-12-01</fund_inception_date>
    <status_date>2023-03-16</status_date>
    <url>https://fondswelt.hansainvest.com/de/fonds/details/151</url>
  </fund>
</root>

Errors

Error response (example)

{
    "title": "No ISIN provided",
    "type": "https://api.hansainvest.com/docs/v1/endpoints/index/#error-400-noisin",
    "status": 404
}