GetWorkUnitsRawPaged

Reporting API: Returns one page of the account's project time registrations with total counts on the root.


API	Reporting API (raw extracts)
Endpoint	`POST https://app{server-number}.timelog.com/{account}/Service.asmx`
SOAPAction	`http://www.timelog.com/ws/tlp/v4_4/GetWorkUnitsRawPaged`
Content-Type	`text/xml; charset=utf-8`
Authentication	`siteCode`, `apiID` and `apiPassword` as the first three parameters. See Authentication
Changes data	No. Safe to retry.
Paging	Yes

How it works

Otherwise the call silently returns EVERYTHING, exactly like GetWorkUnitsRaw. pageSize has no upper bound.

Parameters

Each parameter has one label: Required, Conditional (required depending on other values) or Optional. Send them in the order shown.

siteCodestring

Required

Your account's site code, from the Reporting API settings.

apiIDstring

Required

The Reporting API ID, from the Reporting API settings.

apiPasswordstring

Required

The Reporting API password, from the Reporting API settings.

workUnitIDinteger

Required

Time registration ID. 0 = no filter.

employeeIDinteger

Required

0 = no filter.

allocationIDinteger

Required

0 = no filter.

taskIDinteger

Required

Task. 0 = no filter.

projectIDinteger

Required

0 = no filter.

departmentIDinteger

Required

Department stored on the registration. 0 = no filter.

startDatestring

Optional. Send yyyy-MM-dd.

endDatestring

Optional. Registration date <= value.

pagestring

Optional. 1-based page number, sent as a STRING. A page beyond the last returns an empty page whose root reports TotalRecords=0 / TotalPages=0.

pageSizestring

Optional. No server maximum.

Request

POST /{account}/Service.asmx HTTP/1.1
Host: app{server-number}.timelog.com
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://www.timelog.com/ws/tlp/v4_4/GetWorkUnitsRawPaged"

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:tlp="http://www.timelog.com/ws/tlp/v4_4">
  <soap:Body>
    <tlp:GetWorkUnitsRawPaged>
      <tlp:siteCode>{siteCode}</tlp:siteCode>
      <tlp:apiID>{apiID}</tlp:apiID>
      <tlp:apiPassword>{apiPassword}</tlp:apiPassword>
      <tlp:workUnitID>0</tlp:workUnitID>
      <tlp:employeeID>0</tlp:employeeID>
      <tlp:allocationID>0</tlp:allocationID>
      <tlp:taskID>0</tlp:taskID>
      <tlp:projectID>0</tlp:projectID>
      <tlp:departmentID>0</tlp:departmentID>
      <tlp:startDate>{startDate}</tlp:startDate>
      <tlp:endDate>{endDate}</tlp:endDate>
      <tlp:page>{page}</tlp:page>
      <tlp:pageSize>{pageSize}</tlp:pageSize>
    </tlp:GetWorkUnitsRawPaged>
  </soap:Body>
</soap:Envelope>

curl -X POST "https://app{server-number}.timelog.com/{account}/Service.asmx" \
  -H "Content-Type: text/xml; charset=utf-8" \
  -H 'SOAPAction: "http://www.timelog.com/ws/tlp/v4_4/GetWorkUnitsRawPaged"' \
  --data-binary @request.xml

import requests

URL = "https://app{server-number}.timelog.com/{account}/Service.asmx"
SOAP_ACTION = '"http://www.timelog.com/ws/tlp/v4_4/GetWorkUnitsRawPaged"'

envelope = """<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:tlp="http://www.timelog.com/ws/tlp/v4_4">
  <soap:Body>
    <tlp:GetWorkUnitsRawPaged>
      <tlp:siteCode>{siteCode}</tlp:siteCode>
      <tlp:apiID>{apiID}</tlp:apiID>
      <tlp:apiPassword>{apiPassword}</tlp:apiPassword>
      <tlp:workUnitID>0</tlp:workUnitID>
      <tlp:employeeID>0</tlp:employeeID>
      <tlp:allocationID>0</tlp:allocationID>
      <tlp:taskID>0</tlp:taskID>
      <tlp:projectID>0</tlp:projectID>
      <tlp:departmentID>0</tlp:departmentID>
      <tlp:startDate>{startDate}</tlp:startDate>
      <tlp:endDate>{endDate}</tlp:endDate>
      <tlp:page>{page}</tlp:page>
      <tlp:pageSize>{pageSize}</tlp:pageSize>
    </tlp:GetWorkUnitsRawPaged>
  </soap:Body>
</soap:Envelope>"""

response = requests.post(
    URL,
    data=envelope.encode("utf-8"),
    headers={"Content-Type": "text/xml; charset=utf-8", "SOAPAction": SOAP_ACTION},
    timeout=300,
)
rows = parse_result(response)  # see "Responses and errors"

Replace every {…} placeholder with your own value.

Response

The result is an XML document inside GetWorkUnitsRawPagedResult: a tlp:WorkUnits root with one tlp:WorkUnit element per record. Check the response format first: the same slot also carries the empty result and errors.

tlp:WorkUnitWorkUnitRaw[]

One element per record. Fields without a value are left out of the element, so treat every field as optional.

Example response

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <GetWorkUnitsRawPagedResponse xmlns="http://www.timelog.com/ws/tlp/v4_4">
      <GetWorkUnitsRawPagedResult>
        <tlp:WorkUnits xmlns:tlp="http://www.timelog.com/XML/Schema/tlp/v4_4">
          <tlp:WorkUnit ID="1001" OldID="12">
            <tlp:TimeRegistrationGuid>3F2504E0-4F89-41D3-9A0C-0305E82C3323</tlp:TimeRegistrationGuid>
            <tlp:WorkUnitGuid>3F2504E0-4F89-41D3-9A0C-0305E82C3324</tlp:WorkUnitGuid>
            <tlp:OvertimeFactor>0</tlp:OvertimeFactor>
            <tlp:EmployeeID>12</tlp:EmployeeID>
            <tlp:EmployeeInitials>ABC</tlp:EmployeeInitials>
            <tlp:EmployeeFirstName>Anna</tlp:EmployeeFirstName>
            <tlp:EmployeeLastName>Example</tlp:EmployeeLastName>
            <tlp:AllocationID>12</tlp:AllocationID>
            <tlp:TaskID>12</tlp:TaskID>
            <tlp:TaskName>Example task</tlp:TaskName>
            <tlp:ProjectID>12</tlp:ProjectID>
            <tlp:ProjectName>Example project</tlp:ProjectName>
            <tlp:CustomerId>12</tlp:CustomerId>
            <tlp:CustomerName>Example Customer A/S</tlp:CustomerName>
            <tlp:Date>2026-10-01T00:00:00</tlp:Date>
            <tlp:StartTime>2026-10-01T00:00:00</tlp:StartTime>
            <tlp:EndTime>2026-12-31T00:00:00</tlp:EndTime>
            <tlp:Note>Example text</tlp:Note>
            <tlp:DepartmentID>12</tlp:DepartmentID>
            <tlp:DepartmentName>Example department</tlp:DepartmentName>
            <tlp:AdditionalTextField>Example text</tlp:AdditionalTextField>
            <tlp:ActualExchangeRate>950.0000</tlp:ActualExchangeRate>
            <tlp:RegHours>7.5000</tlp:RegHours>
            <tlp:RegHourlyRate>950.0000</tlp:RegHourlyRate>
            <tlp:RegHourlyRateProjectCurrency>950.0000</tlp:RegHourlyRateProjectCurrency>
            <tlp:RegAmount>950.0000</tlp:RegAmount>
            <tlp:RegAmountProjectCurrency>950.0000</tlp:RegAmountProjectCurrency>
            <tlp:EstimatedHours>7.5000</tlp:EstimatedHours>
            <tlp:EstimatedHourlyRate>950.0000</tlp:EstimatedHourlyRate>
            <tlp:EstimatedHourlyRateProjectCurrency>950.0000</tlp:EstimatedHourlyRateProjectCurrency>
            <tlp:EstimatedAmount>950.0000</tlp:EstimatedAmount>
            <tlp:EstimatedAmountProjectCurrency>950.0000</tlp:EstimatedAmountProjectCurrency>
            <tlp:BARHours>7.5000</tlp:BARHours>
            <tlp:BARHourlyRate>950.0000</tlp:BARHourlyRate>
            <tlp:BARHourlyRateProjectCurrency>950.0000</tlp:BARHourlyRateProjectCurrency>
            <tlp:BARAmount>950.0000</tlp:BARAmount>
            <tlp:BARAmountProjectCurrency>950.0000</tlp:BARAmountProjectCurrency>
            <tlp:InvoicedHours>7.5000</tlp:InvoicedHours>
            <tlp:InvoicedHourlyRate>950.0000</tlp:InvoicedHourlyRate>
            <tlp:InvoicedHourlyRateProjectCurrency>950.0000</tlp:InvoicedHourlyRateProjectCurrency>
            <tlp:InvoicedAmount>950.0000</tlp:InvoicedAmount>
            <tlp:InvoicedAmountProjectCurrency>950.0000</tlp:InvoicedAmountProjectCurrency>
            <tlp:InvHours>7.5000</tlp:InvHours>
            <tlp:InvAmount>950.0000</tlp:InvAmount>
            <tlp:CostAmount>950.0000</tlp:CostAmount>
            <tlp:CostAmountCurrency>950.0000</tlp:CostAmountCurrency>
            <tlp:HourlyRateId>12</tlp:HourlyRateId>
            <tlp:InvoiceStatus>1</tlp:InvoiceStatus>
            <tlp:BillableStatus>1</tlp:BillableStatus>
            <tlp:IsBillable>1</tlp:IsBillable>
            <tlp:ApprovedStatus>1</tlp:ApprovedStatus>
            <tlp:MonthlyPeriod>2026-10</tlp:MonthlyPeriod>
            <tlp:CreatedAt>2026-10-01T00:00:00</tlp:CreatedAt>
            <tlp:CreatedByEmployeeId>12</tlp:CreatedByEmployeeId>
            <tlp:CreatedBy>ABC</tlp:CreatedBy>
            <tlp:LastModifiedAt>2026-10-01T00:00:00</tlp:LastModifiedAt>
            <tlp:LastModifiedByEmployeeId>12</tlp:LastModifiedByEmployeeId>
            <tlp:LastModifiedBy>ABC</tlp:LastModifiedBy>
            <tlp:UserID>12</tlp:UserID>
          </tlp:WorkUnit>
        </tlp:WorkUnits>
      </GetWorkUnitsRawPagedResult>
    </GetWorkUnitsRawPagedResponse>
  </soap:Body>
</soap:Envelope>

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <GetWorkUnitsRawPagedResponse xmlns="http://www.timelog.com/ws/tlp/v4_4">
      <GetWorkUnitsRawPagedResult>
        <tlp:WorkUnits resultEmpty="true" xmlns:tlp="http://www.timelog.com/XML/Schema/tlp/v4_4"></tlp:WorkUnits>
      </GetWorkUnitsRawPagedResult>
    </GetWorkUnitsRawPagedResponse>
  </soap:Body>
</soap:Envelope>

Example error

Wrong credentials, or a call over plain HTTP:

HTTP/1.1 401 Unauthorized
Content-Type: text/xml; charset=utf-8

<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
  <soap:Body>
    <GetWorkUnitsRawPagedResponse xmlns="http://www.timelog.com/ws/tlp/v4_4">
      <GetWorkUnitsRawPagedResult>
        <tlp:Errors xmlns:tlp="http://www.timelog.com/XML/Schema/tlp/v4_4">
          <tlp:Error>Access denied. Check siteCode, apiID, apiPassword and SSL settings</tlp:Error>
        </tlp:Errors>
      </GetWorkUnitsRawPagedResult>
    </GetWorkUnitsRawPagedResponse>
  </soap:Body>
</soap:Envelope>

Data and No rows are illustrative examples: the format follows the service's documented output, with made-up values (only one record shown). Access denied was recorded from a real call with wrong credentials (to GetCustomersShortList; every data method answers the same way).

Errors

The errors every method can return (access denied, operation failed, invalid request) are listed once in Responses and errors.

Errors specific to this method:

HTTP status	What you get	What it means	What to do
200	A document that stops in the middle (does not parse to the end)	The extract is sent row by row; a failure after the first rows were sent cuts the document off.	Treat a document that does not parse as failed and repeat the call with a shorter date range.

Was this page helpful?