List Endpoint Access Requests

curl -X GET "https://<hostname>/ekranapi/AccessRequests/GetEndpointAccessRequests?start=2023-02-01&end=2023-02-28&count=1000" \
  -H "ApiKey: xJ)tsCNcpj)l+]}(@_|lt!t………"

{
  "afterId": null,
  "requests": [
    {
      "id": 1,
      "requestedAt": "2023-02-08T13:26:37.763",
      "userName": "windev2210eval\\user",
      "sessionDuration": "00:40:34.4150000",
      "sessionProductiveDuration": "00:28:02.8690000",
      "status": "Approved",
      "remoteIp": "172.31.240.1",
      "statusChangedAt": "2023-02-08T13:32:34.437",
      "statusChangedBy": "admin",
      "statusChangeComment": "approve message"
    },
    {
      "id": 2,
      "requestedAt": "2023-02-08T14:30:55.527",
      "userName": "windev2210eval\\user",
      "sessionDuration": "00:04:15.2660000",
      "sessionProductiveDuration": "00:04:12.2760000",
      "status": "Approved",
      "remoteIp": "172.31.240.1",
      "statusChangedAt": "2023-02-08T14:31:05.187",
      "statusChangeBy": "admin",
      "statusChangeComment": "approve 2 message"
    }
  ]
}

Returns processed Endpoint Access Control access requests with the complete audit trail per request — who requested access, who approved or denied it, when, what comment was left, and how long the resulting session lasted. Paginated with up to 1000 requests per call.

GET https://<hostname>/ekranapi/AccessRequests/GetEndpointAccessRequests

Authentication

string

required

Your Active API Key from the Management Tool.

Query parameters

string

Access requests processed after this time are included.Accepted formats: 2021-04-01, 2021-04-01T12:00, 2021-04-01T12:00:00.

string

Access requests processed before this time are included.

int

default:"1000"

Number of access requests to return per request.Default: 1000. Maximum: 1000.

int

Cursor for pagination — the ID after which to start returning records. Use the afterId from a previous response to fetch the next batch.

Requesting more than 1000 access requests (count > 1000) returns HTTP 400 Bad Request.

If both start and end are omitted, all access requests in the database are returned (subject to pagination).

Response (200 OK)

int

The ID of the first access request in the batch — pass it as afterId on the next request to fetch the next page. null indicates the last page.

array

Array of access request objects:

Show Access request

int

A service field required for pagination.

date

When the access request was made.

string

The user name of the user requesting access.

timespan

Total session time after access was granted — format hh:mm:ss.fffffff.

timespan

Total session time excluding idle time.

string

The access request status — Approved, Denied, or Expired.

string

The IP address of the user requesting access.

date

When the request status was changed (when it was approved, denied, or expired).

string

The user name of the user who changed the status of the request.

string

The comment left by the user who changed the status.

Example

curl -X GET "https://<hostname>/ekranapi/AccessRequests/GetEndpointAccessRequests?start=2023-02-01&end=2023-02-28&count=1000" \
  -H "ApiKey: xJ)tsCNcpj)l+]}(@_|lt!t………"

{
  "afterId": null,
  "requests": [
    {
      "id": 1,
      "requestedAt": "2023-02-08T13:26:37.763",
      "userName": "windev2210eval\\user",
      "sessionDuration": "00:40:34.4150000",
      "sessionProductiveDuration": "00:28:02.8690000",
      "status": "Approved",
      "remoteIp": "172.31.240.1",
      "statusChangedAt": "2023-02-08T13:32:34.437",
      "statusChangedBy": "admin",
      "statusChangeComment": "approve message"
    },
    {
      "id": 2,
      "requestedAt": "2023-02-08T14:30:55.527",
      "userName": "windev2210eval\\user",
      "sessionDuration": "00:04:15.2660000",
      "sessionProductiveDuration": "00:04:12.2760000",
      "status": "Approved",
      "remoteIp": "172.31.240.1",
      "statusChangedAt": "2023-02-08T14:31:05.187",
      "statusChangeBy": "admin",
      "statusChangeComment": "approve 2 message"
    }
  ]
}

Pagination loop: call the endpoint with count=1000 and no afterId. From the response, take afterId and pass it as the parameter in the next call. When the response contains afterId: null, you’ve reached the last page.

For compliance reporting (SOC 2, PCI DSS, audit evidence), this endpoint provides the complete access-request audit trail in a single call: who requested, who approved, when, why, and what they did with the access. Pipe it into your compliance dashboard or evidence-collection pipeline.

Errors

See Status codes. Common errors:

400 Bad Request — invalid time format, or count > 1000.
403 Forbidden — Data Connector not registered.

Endpoint Access Control

The Management Tool feature that produces these requests.

Audit log

Complementary audit data for administrative actions.

List alerts

Alert events triggered during access-granted sessions.

API reference

Base URL, authentication, status codes.

Overview

Application Credentials Broker

Data Connector API

SSO & LDAP

SIEM & Ticketing systems

List Endpoint Access Requests

Authentication

Query parameters

Response (200 OK)

Example

Errors

Endpoint Access Control

Audit log

List alerts

API reference

​Authentication

​Query parameters

​Response (200 OK)

​Example

​Errors

​Related

Endpoint Access Control

Audit log

List alerts

API reference

Authentication

Query parameters

Response (200 OK)

Example

Errors

Related