Get Access authentication logs

GET /accounts/{account_id}/access/logs/access_requests

Copy endpoint

https://api.cloudflare.com/client/v4

Gets a list of Access authentication audit logs for an account.

Parameters

path Path Parameters

Name	Type
`account_id` required	type AccessIdentifier = string

query Query Parameters

Name	Type
`limit` The maximum number of log entries to retrieve.	number
`direction` The chronological sorting order for the logs.	"desc" \| "asc"
`since` The earliest event timestamp to query.	string
`until` The latest event timestamp to query.	string
`page`	number
`per_page`	number

Responses

200 application/json

Get Access authentication logs response

type AccessAccessRequestsComponentsSchemasResponseCollection = interface AccessApiResponseCommon {
errors:

AccessMessages

type AccessMessages = {
code: number;
documentation_url?: string;
message: string;
source?: { pointer?: string; };
}[]

;
messages:

AccessMessages

type AccessMessages = {
code: number;
documentation_url?: string;
message: string;
source?: { pointer?: string; };
}[]

;
success: true;
} & { result?:

AccessAccessRequests

interface AccessAccessRequests {
action?: AccessAction;
allowed?: AccessAllowed;
app_domain?: AccessAppDomain;
app_uid?: AccessAppUid;
connection?: AccessConnection;
created_at?: AccessTimestamp;
ip_address?: AccessIp;
ray_id?: AccessRayId;
user_email?: AccessComponentsSchemasEmail;
}

[]; }

Client Errors

4XX application/json

Get Access authentication logs response failure

interface AccessApiResponseCommonFailure {
errors:

AccessMessages

type AccessMessages = {
code: number;
documentation_url?: string;
message: string;
source?: { pointer?: string; };
}[]

;
messages:

AccessMessages

type AccessMessages = {
code: number;
documentation_url?: string;
message: string;
source?: { pointer?: string; };
}[]

;
result: null;
success: false;
}