Try it

Make your first Reporting API calls without writing code: with the ready-to-run Bruno collection, in Postman, or in SoapUI.

The fastest way to see what the Reporting API returns is to call it. Pick one client:

Client	Best for	Setup
Bruno (recommended)	Every method ready to run, filters pre-filled	Download the collection, fill in 4 values
Postman	Teams that already use Postman	Import the service description (WSDL)
SoapUI	Generating requests straight from the service description	Import the WSDL

Every method takes the three credentials siteCode, apiID and apiPassword first; there is no login call and no token. You find all three under System Administration > Integrations and API > Reporting API settings. See Authentication.

Narrow the filters before running a raw extract. Most raw extracts return everything that matches in one response. On a large account an unfiltered call, especially for time registrations, can be very large and slow. Start with a short date range or a single project or employee.

Bruno (recommended)

A ready-to-run collection for Bruno, a free, open-source API client: every method on these pages, with the request already built, the filters pre-filled, and a test that tells you whether the call worked.

Download the Reporting API collection

A zip file with the Bruno collection: one folder per entity, split into raw extracts and short lists.

Install Bruno and open the collection

Download Bruno from usebruno.com and install it; no account is needed. Unzip the download, choose Open Collection and select the unzipped folder.

Fill in the environment

Select the TimeLog environment (top right) and set baseUrl to your TimeLog address, https://app{server-number}.timelog.com/{account}. Then set the secrets siteCode, apiID and apiPassword. Bruno keeps secrets on your machine only.

Check the credentials

Run 01 Credentials / ValidateCredentials. true means you are ready.

Make your first call

Open a Short lists request (they are small) and run it. The Tests tab shows whether the call worked; the console shows how many records came back.

What's in the collection:

Folder	What it contains
`01 Credentials`	ValidateCredentials (run this first)
`02 Customers` … `15 Salary`	One folder per entity (customers, projects, employees, time registrations, …), each split into Raw extracts (full records) and Short lists (IDs and names for look-ups)

Every request has a Docs tab with what it does and its parameters, and a Tests tab that checks the result.
Filters are pre-filled with their "no filter" value, usually 0 or -1. Each request's Docs tab says which value means what.
Date filters use the environment variables fromDate and toDate. Set them to the period you need.

Postman

Postman builds a request for every method from the service description (WSDL).

Import the WSDL

Choose Import, open the Link tab, enter https://app{server-number}.timelog.com/{account}/Service.asmx?WSDL and click Continue, then Import. Postman creates a collection named Service, already pointing to your site.

Keep one folder

The collection has four folders with the same methods, one per way of calling them. Keep ServiceSoap (SOAP, XML body) or ServiceHttpPost (a plain form post, no XML), and delete the other two. Do not use ServiceHttpGet: it puts apiPassword in the URL, where it ends up in browser history and logs.

Fill in the parameters

Open a method. Every parameter is filled with the placeholder string: replace each one, starting with siteCode, apiID and apiPassword. Send every parameter, also the ones you do not filter on; the method's page lists the "no filter" values.

Send

Click Send. The response is the method's XML document, or tlp:Errors when the call failed.

You can also call a method without importing anything: send a POST to https://app{server-number}.timelog.com/{account}/Service.asmx/{Method} with Body set to x-www-form-urlencoded and one key per parameter. The Power BI guide uses the same form post.

SoapUI

Create a SOAP project

In SoapUI, choose SOAP in the toolbar and enter https://app{server-number}.timelog.com/{account}/Service.asmx?WSDL. Click OK: SoapUI creates every method.

Create a request

Right-click a method and choose New Request. SoapUI generates the request body.

Fill in and send

Fill in the credentials and the other parameters, and click the run button. The answer appears in the Response pane.

What each HTTP status and error means is explained in Responses and errors.

The Reporting API returns your account's reporting data, including personal data. Keep the credentials safe and treat exported results with the same care as the data in TimeLog.

Was this page helpful?

Try it

Bruno (recommended)

Postman

SoapUI

Next