GetCheckInLog API¶
Returns the check-in log for documents matching the specified date range and path filter.
Endpoint¶
Methods¶
- GET
/srv.asmx/GetCheckInLog?authenticationTicket=...&startDate=...&endDate=...&pathFilter=... - POST
/srv.asmx/GetCheckInLog(form data) - SOAP Action:
http://tempuri.org/GetCheckInLog
Parameters¶
| Parameter | Type | Required | Description |
|---|---|---|---|
authenticationTicket |
string | Yes | Authentication ticket obtained from AuthenticateUser |
startDate |
DateTime | No | Start date for the log query range |
endDate |
DateTime | No | End date for the log query range |
pathFilter |
string | No | Path filter scoping the query (see Required Permissions for how this affects access control). Supports wildcard * at the end (e.g. \MyLibrary\Reports*). |
Response Structure¶
Success Response¶
<response success="true">
<logs>
<log TYPE="DOCUMENT" ID="1234" NAME="Report.docx" DATE="2026-02-01 14:30:00"
DOMAINID="1" DOMAINNAME="MyLibrary" PATH="\MyLibrary\Reports"
USERID="5" FULLNAME="John Smith" />
<log TYPE="DOCUMENT" ID="1235" NAME="Invoice.pdf" DATE="2026-01-28 09:15:00"
DOMAINID="1" DOMAINNAME="MyLibrary" PATH="\MyLibrary\Finance"
USERID="8" FULLNAME="Jane Doe" />
</logs>
</response>
Empty Result¶
Error Response¶
Log Entry Attributes¶
Each <log> element contains:
| Attribute | Type | Description |
|---|---|---|
TYPE |
string | Object type — always DOCUMENT |
ID |
integer | Document identifier |
NAME |
string | Name of the checked-in document |
DATE |
DateTime | Date and time of the check-in action |
DOMAINID |
integer | Library/domain identifier |
DOMAINNAME |
string | Library name (first path segment of the document path) |
PATH |
string | Full parent path of the document |
USERID |
integer | Identifier of the user who performed the check-in |
FULLNAME |
string | Full name of the user who performed the check-in |
Required Permissions¶
The required permission level depends on the pathFilter value:
pathFilter value |
Required permission |
|---|---|
| Empty or omitted | System-wide ViewAuditLogs admin permission |
| Unresolvable path (library name not found) | System-wide ViewAuditLogs admin permission |
Starts with a valid library name (e.g. \MyLibrary or \MyLibrary\Reports*) |
ViewAuditLogs permission for that library only |
When a library name is resolved from the path, the query is automatically scoped to that library. Library-level audit log administrators can therefore query their own library without system-wide admin rights.
Example Requests¶
Request (GET) — system-wide query¶
GET /srv.asmx/GetCheckInLog?authenticationTicket=abc123-def456&startDate=2026-01-01&endDate=2026-02-01 HTTP/1.1
Host: server.example.com
Request (GET) — scoped to a library¶
GET /srv.asmx/GetCheckInLog?authenticationTicket=abc123-def456&startDate=2026-01-01&endDate=2026-02-01&pathFilter=\MyLibrary* HTTP/1.1
Host: server.example.com
Request (POST)¶
POST /srv.asmx/GetCheckInLog HTTP/1.1
Content-Type: application/x-www-form-urlencoded
authenticationTicket=abc123-def456&startDate=2026-01-01&endDate=2026-02-01&pathFilter=\MyLibrary*
Request (SOAP 1.1)¶
POST /srv.asmx HTTP/1.1
Content-Type: text/xml; charset=utf-8
SOAPAction: "http://tempuri.org/GetCheckInLog"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetCheckInLog xmlns="http://tempuri.org/">
<authenticationTicket>abc123-def456</authenticationTicket>
<startDate>2026-01-01</startDate>
<endDate>2026-02-01</endDate>
<pathFilter>\MyLibrary*</pathFilter>
</GetCheckInLog>
</soap:Body>
</soap:Envelope>
Notes¶
- Results are ordered by action date descending (most recent first).
- When
pathFilterbegins with a valid library name, the query is scoped to that library andDomainIdis set automatically — you do not need to specify the domain separately. - If
pathFilteris exactly a library name with no sub-path (e.g.\MyLibrary), the path filter is cleared internally and all check-in records within that library are returned. - If
startDateandendDateare omitted, all available log entries matching the path filter are returned. - Check-in logging must be enabled in the domain policies for entries to be recorded.
Error Codes¶
| Error | Description |
|---|---|
[901] Session expired or Invalid ticket |
Invalid or expired authentication ticket |
| Access denied | Caller does not have the required ViewAuditLogs permission (see Required Permissions) |
| Folder not found / Document not found | The path or ID specified in the filter does not exist |
Related APIs¶
GetCheckoutLog- Get checkout log entriesGetDeleteLog- Get deletion log entriesGetNewDocumentsAndFoldersLog- Get creation log entries for new documents and foldersGetVersionCreateLog- Get version creation log entries
Version History¶
- Updated:
pathFilternow controls both query scope and required permission level.DOMAINNAMEattribute added to each log entry. - New: Added to provide programmatic access to check-in log previously only available through the Control Panel UI