GetMilestonesRaw
Reporting API: Returns the account's non-recurring project milestones with date, responsible employee, completion and department.
| 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/GetMilestonesRaw |
| 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 | No: the whole result comes in one response. Narrow it with the filters. |
How it works
Filters: milestone, project, completed status.
Parameters
Each parameter has one label: Required, Conditional (required depending on other values) or Optional. Send them in the order shown.
siteCodestring
RequiredYour account's site code, from the Reporting API settings.
apiIDstring
RequiredThe Reporting API ID, from the Reporting API settings.
apiPasswordstring
RequiredThe Reporting API password, from the Reporting API settings.
milestoneIDinteger
Required0 = no filter.
projectIDinteger
Required0 = no filter.
statusinteger
RequiredUse -1 for no filter. Completion flag; sent when >= 0.
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/GetMilestonesRaw"
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tlp="http://www.timelog.com/ws/tlp/v4_4">
<soap:Body>
<tlp:GetMilestonesRaw>
<tlp:siteCode>{siteCode}</tlp:siteCode>
<tlp:apiID>{apiID}</tlp:apiID>
<tlp:apiPassword>{apiPassword}</tlp:apiPassword>
<tlp:milestoneID>0</tlp:milestoneID>
<tlp:projectID>0</tlp:projectID>
<tlp:status>-1</tlp:status>
</tlp:GetMilestonesRaw>
</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/GetMilestonesRaw"' \
--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/GetMilestonesRaw"'
envelope = """<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:tlp="http://www.timelog.com/ws/tlp/v4_4">
<soap:Body>
<tlp:GetMilestonesRaw>
<tlp:siteCode>{siteCode}</tlp:siteCode>
<tlp:apiID>{apiID}</tlp:apiID>
<tlp:apiPassword>{apiPassword}</tlp:apiPassword>
<tlp:milestoneID>0</tlp:milestoneID>
<tlp:projectID>0</tlp:projectID>
<tlp:status>-1</tlp:status>
</tlp:GetMilestonesRaw>
</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 GetMilestonesRawResult: a tlp:Milestones root with one tlp:Milestone element per record. Check the response format first: the same slot also carries the empty result and errors.
Order: Project ID, then the milestone's SortOrder.
tlp:MilestoneMilestonesRaw[]
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>
<GetMilestonesRawResponse xmlns="http://www.timelog.com/ws/tlp/v4_4">
<GetMilestonesRawResult>
<tlp:Milestones xmlns:tlp="http://www.timelog.com/XML/Schema/tlp/v4_4">
<tlp:Milestone ID="1001">
<tlp:MilestoneTypeID>12</tlp:MilestoneTypeID>
<tlp:ProjectID>12</tlp:ProjectID>
<tlp:ProjectName>Example project</tlp:ProjectName>
<tlp:Date>2026-10-01T00:00:00</tlp:Date>
<tlp:ResponsibleEmployeeID>12</tlp:ResponsibleEmployeeID>
<tlp:ResponsibleEmployeeName>Example responsible employee</tlp:ResponsibleEmployeeName>
<tlp:Text>Example text</tlp:Text>
<tlp:Completed>0</tlp:Completed>
<tlp:WBSNo>1001</tlp:WBSNo>
<tlp:SortOrder>0</tlp:SortOrder>
<tlp:DepartmentID>12</tlp:DepartmentID>
</tlp:Milestone>
</tlp:Milestones>
</GetMilestonesRawResult>
</GetMilestonesRawResponse>
</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>
<GetMilestonesRawResponse xmlns="http://www.timelog.com/ws/tlp/v4_4">
<GetMilestonesRawResult>
<tlp:Milestones resultEmpty="true" xmlns:tlp="http://www.timelog.com/XML/Schema/tlp/v4_4"></tlp:Milestones>
</GetMilestonesRawResult>
</GetMilestonesRawResponse>
</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>
<GetMilestonesRawResponse xmlns="http://www.timelog.com/ws/tlp/v4_4">
<GetMilestonesRawResult>
<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>
</GetMilestonesRawResult>
</GetMilestonesRawResponse>
</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.
This method has no errors of its own beyond the shared ones.
Was this page helpful?