Reports
Related guide: Query reports.
GET /report
Queries the transfer records of the authenticated user.
Access: session (Bearer token or cookie).
| Parameter | In | Type | Required | Default | Description |
|---|---|---|---|---|---|
filterdirection | query | integer | Yes | — | Transfer type: 5 = completed downloads (the user received the file; event STCPEVTENDSENDFILE) or 7 = completed uploads (the user sent the file; event STCPEVTENDRECEIVEFILE). Other values return 400. |
days | query | integer | No | 1 | Period queried, in days, counted back from the time of the request. 0 or an invalid value uses 1. |
page | query | integer | No | 0 | Results page, starting at 0. Each page has up to 100 records (limit configurable by the administrator, up to 1000). |
filterfile | query | string | No | — | Filter by part of the file name. |
The report returns only transfers completed successfully by the authenticated user.
Responses
| HTTP | Meaning | Body |
|---|---|---|
200 | Transfer records. | ReportResponse |
401 | Credential not accepted. | — |
400 | filterdirection missing or different from 5 and 7. | — |
403 | User connection blocked or outside the time window. | — |
GET /directlink/v2/report?filterdirection=5&days=7&page=0 HTTP/1.1
Host: api.example.com
Authorization: Bearer <access_token>
Accept: application/json