Data ophalen uit Tim via API (voorbeeld Postman)

Met deze handleiding kun je rechtstreeks data uit Tim ophalen via de API en testen met Postman.

Voorbeeld: Tim lijsten

Wat heb je nodig?

Voor de koppeling heb je de volgende gegevens nodig:

  • API-key (via Softmakers)
  • E-mailadres van de Tim-Api gebruiker
  • DataSetName (naam van dataset in Tim), zelf aanmaken in Tim
  • DataListName (naam van de lijst binnen de dataset)
  • TenantId (via Softmakers)

API endpoint

https://start.timsaas.com/timapi/api/ReportDataSetExport

Hoe werkt het?

Je doet een HTTP GET request naar het endpoint met parameters en headers.

De API geeft vervolgens JSON terug met de data uit Tim.

Belangrijk:

  • De kolommen komen rechtstreeks uit de DataList in Tim
  • Er is geen vast schema

Testen met Postman (stap-voor-stap)

1. Maak een nieuwe request

  • Open Postman
  • Klik op New → HTTP Request
  • Zet methode op GET

2. Vul de URL in

https://start.timsaas.com/timapi/api/ReportDataSetExport

3. Voeg query parameters toe

Zoek eerst de benamingen in Tim, ga naar lijsten Kies een lijst, kies 'Exporteren' →  'Power BI-datasets instellen' Aan de linkerkant zie je de "POWERBI DATASETS". Als deze lijst leeg is, moet je zelf een nieuwe maken. Dit is de DataSetName. Voorbeeldnaam: PBI Omzetanalyse


Zodra je in Tim de juiste "POWERBI DATASETS" hebt gekozen, zoek je de lijst onder "GEKOPPELDE LIJSTEN", de DataListName. Rechts van het scherm zie je nog beschikbare lijsten, dit zijn lijsten die je ook kunt koppelen onder de "GEKOPPELDE LIJSTEN" 

Voorbeeldnaam: PBI Omzet klanten


In Postman onder Params:

KeyValue
DataSetNamePBI Omzetanalyse
DataListNamePBI Omzet klanten
emailjouwemail@bedrijf.nl
tenantId7171

4. Voeg headers toe

In tab Headers:

KeyValue
Acceptapplication/json
X-Api-Keyjouw-api-key

5. Klik op “Send”

✅ Je krijgt nu een response terug met JSON data.

Wat krijg je terug?

De response bevat:

  • Eén object met daarin een lijst (array) van records
  • Elke record = één rij uit de DataList
  • Kolommen = exact zoals ingericht in Tim

Voorbeeld response (vereenvoudigd), zelf in terichten in Tim

[
  {
    "Klant": "Bedrijf A",
    "Omzet": 12000,
    "Datum": "2026-01-01"
  },
  {
    "Klant": "Bedrijf B",
    "Omzet": 8500,
    "Datum": "2026-01-02"
  }
]
``

Wanneer wordt data opgehaald?

Elke keer dat je de request uitvoert:

  • krijg je de actuele stand van de DataList

Aandachtspunten

  • Kolomnamen kunnen wijzigen → kan je koppeling breken
  • DataSetName en DataListName moeten exact kloppen
  • Geen vast datamodel of versiebeheer
  • API-key goed beveiligen

Samenvatting

  • Data wordt opgehaald via een simpele HTTP GET
  • Resultaat is JSON
  • Je kunt dit direct gebruiken in:
    • Postman (testen)
    • C#
    • Python
    • andere integraties