ACaccessowl
access_requests

List access requests

Changed on

Returns a paginated list of access requests visible to the authenticated caller.

get/api/v1/access_requests

Request

  • Base URL
    https://app.accessowl.io
  • URL
    https://app.accessowl.io/api/v1/access_requests
  • Auth
    HTTP bearer

Query parameters

limitinteger

Maximum results to return (default: 20, max: 100)

cursorstring

Opaque cursor returned in the previous response's meta.next_cursor. Omit for the first page.

user_idstring uuid

Filter by the grantee user (the user the request is for)

application_idstring uuid

Filter by application

status'pending_approval' | 'pending_permissions_assignment' | 'scheduled' | 'pending_dependency' | 'processing_access' | 'access_granted' | 'denied' | 'rejected'

Filter by request status

Response

Access request list

Example response

{
  "data": [
    {
      "application_id": "7488a646-e31f-11e4-aace-600308960662",
      "approval_steps": [
        {
          "approvers": [
            {
              "decided_at": "2023-01-15T11:00:00Z",
              "decided_by_user_id": "9488a646-e31f-11e4-aace-600308960667",
              "status": "approved",
              "user_id": "9488a646-e31f-11e4-aace-600308960667"
            }
          ],
          "decided_at": "2023-01-15T11:00:00Z",
          "status": "approved",
          "step": 1,
          "strategy": "all"
        },
        {
          "approvers": [
            {
              "decided_at": null,
              "decided_by_user_id": null,
              "status": "pending",
              "user_id": "9488a646-e31f-11e4-aace-600308960668"
            },
            {
              "decided_at": null,
              "decided_by_user_id": null,
              "status": "pending",
              "user_id": "9488a646-e31f-11e4-aace-600308960669"
            }
          ],
          "decided_at": null,
          "status": "pending",
          "step": 2,
          "strategy": "first_to_respond"
        },
        {
          "approvers": [
            {
              "decided_at": null,
              "decided_by_user_id": null,
              "status": "pending",
              "user_id": "9488a646-e31f-11e4-aace-60030896066a"
            }
          ],
          "decided_at": null,
          "status": "pending",
          "step": 3,
          "strategy": "all"
        }
      ],
      "duration": "PT1H",
      "expires_at": "2023-01-16T10:30:00Z",
      "grantee_user_id": "9488a646-e31f-11e4-aace-600308960666",
      "id": "8488a646-e31f-11e4-aace-600308960665",
      "inserted_at": "2023-01-15T10:30:00Z",
      "permission_ids": [
        "7488a646-e31f-11e4-aace-600308960664"
      ],
      "provisioning_type": "automatic",
      "request_reason": "Need access to complete Q4 reporting",
      "requestor_user_id": "9488a646-e31f-11e4-aace-600308960666",
      "resource_id": "7488a646-e31f-11e4-aace-600308960663",
      "status": "pending_approval",
      "termination_reason": null
    }
  ],
  "meta": {
    "page": 1,
    "page_size": 20,
    "total_count": 100,
    "total_pages": 5
  }
}

Changes

  • 5a1f071e40d8Revision changes
    • warning

      removed the optional property from the response with the status

  • 209e132db90bRevision changes
    • info

      added the new optional query request parameter application_id

    • info

      added the new optional query request parameter status

    • info

      added the new optional query request parameter user_id

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status