Skip to content

GetAccessesList

Request

Returns list of accesses sorted by latest activity time in descending order.

Endpoint: GET /v1/accesses. Authentication: requires AuthorizationHeader bearer token unless this operation's security is changed. Required AuthMind permission/scope: posture (grant this scope on the API token in Admin > API Tokens; a token without it receives 403 Forbidden). Documented parameters: latest_activity_time_gt, identity_type, directory_type, directory_name, identity, asset, asset_type, from, size, score. Pagination: use from and/or size as documented. Pagination convention for this endpoint: from is a one-based page number (default 1), size is the page length (default 50, subject to this endpoint's documented maximum). Response parsing: inspect success; on failure inspect error, errors, or message depending on the referenced schema.

Security
AuthorizationHeader
Query
latest_activity_time_gtstring

Returns list of accesses having latest activity time greater than the specified time if provided. The format of time is 'YYYY-MM-DD HH:MM:SS'.

Use the timestamp format stated in this endpoint (YYYY-MM-DD HH:MM:SS), interpreted as UTC.

identity_typestring

Identity type

directory_typestring

Directory Type

Allowed values: On-premise, Cloud IDP.

Enum:"On-premise""Cloud IDP"
directory_namestring

Directory Name

identitystring

Identity Name

assetstring

Asset Name

asset_typestring

Asset Type

frominteger

Page number

Pagination parameter. One-based page number for this endpoint (default 1, minimum 1).

sizeinteger

Record per page. Default no of records per page is 50. Maximum allowed records per page is 1000.

Pagination page size / maximum records to return. Respect any endpoint-specific default or maximum stated here.

scorenumber

Filters accesses to include only those with a posture score greater than or equal to the specified value. Score must be greater than or equal to 0.0

curl -i -X GET \
  'https://apidoc.authmind.com/_mock/v1/docs/v1/accesses?latest_activity_time_gt=string&identity_type=string&directory_type=On-premise&directory_name=string&identity=string&asset=string&asset_type=string&from=0&size=0&score=0' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Request completed successfully. See the referenced schema for the response envelope and result payload.

Bodyapplication/json
errorstring

Error message returned when the request fails. This is free-form, human-readable text intended for logging/display -- AuthMind does not define a stable, cross-endpoint error-code contract for it. Branch integration logic on the HTTP status code and the success boolean, not on the contents of this string.

resultobject(models.OutListAccessResultResponse)

Primary response payload for this endpoint.

successboolean

Indicates whether the request was successful.

Response
{
  "error": "",
  "result": {
    "data": [ … ],
    "total": 2
  },
  "success": true
}