---
updatedAt: 2026-06-17T09:51:44.000Z
agentTools:
  projectIndex: https://developers.toriihq.com/llms.txt
---

# List access request policies

Returns the organization’s access request policies.<br/><br/>Use the `fields` query parameter to choose which fields to return — e.g. `fields=id,name,app,approvalFlow,eligibilityGroups,accessDurationsConfig`.<br/><br/>
<p><ul><li>Rate limit: 60 requests per minute</li></ul></p>

# OpenAPI definition

```json
{
  "servers": [
    {
      "url": "https://api.toriihq.com/v1.0"
    }
  ],
  "info": {
    "title": "Torii API Documentation",
    "version": "v1.0",
    "description": "The Torii API provides an easy way to integrate your data in Torii with any external system. The API closely follows REST semantics, uses JSON to encode objects, and relies on standard HTTP codes to signal operation outcomes. Torii APIs consist of both proprietary and SCIM 2.0 APIs."
  },
  "x-readme": {
    "explorer-enabled": true
  },
  "security": [
    {
      "ApiKeyAuth": []
    }
  ],
  "tags": [
    {
      "name": "App Catalog"
    }
  ],
  "openapi": "3.0.0",
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "x-bearer-format": "bearer"
      }
    },
    "schemas": {
      "AccessProfile": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "example": "The Seven - Standard Profile Access"
          },
          "description": {
            "type": "string",
            "example": "Standard access for members of The Seven",
            "nullable": true
          }
        },
        "required": [
          "name"
        ]
      },
      "profiles": {
        "type": "array",
        "description": "The access profiles a user can request under this policy, sorted by name",
        "items": {
          "$ref": "#/components/schemas/AccessProfile"
        }
      },
      "app": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "example": 305
          },
          "name": {
            "type": "string",
            "example": "Compound V Database"
          }
        },
        "required": [
          "id",
          "name"
        ]
      },
      "approvalFlow": {
        "type": "object",
        "example": {
          "name": "Vought VP Approval"
        },
        "nullable": true,
        "properties": {
          "name": {
            "type": "string",
            "example": "Vought VP Approval"
          }
        },
        "required": [
          "name"
        ]
      },
      "provisioningWorkflow": {
        "type": "object",
        "example": {
          "name": "Okta Provisioning"
        },
        "nullable": true,
        "properties": {
          "name": {
            "type": "string",
            "example": "Vought VP Approval"
          }
        },
        "required": [
          "name"
        ]
      },
      "deprovisioningWorkflow": {
        "type": "object",
        "example": {
          "name": "Okta Deprovisioning"
        },
        "nullable": true,
        "properties": {
          "name": {
            "type": "string",
            "example": "Vought VP Approval"
          }
        },
        "required": [
          "name"
        ]
      },
      "Model20": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "example": 7
          },
          "name": {
            "type": "string",
            "example": "The Seven"
          }
        },
        "required": [
          "id",
          "name"
        ]
      },
      "eligibilityGroups": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/Model20"
        }
      },
      "unit": {
        "type": "string",
        "enum": [
          "hour",
          "day",
          "week",
          "month"
        ]
      },
      "Model21": {
        "type": "object",
        "properties": {
          "value": {
            "type": "integer",
            "minimum": 1
          },
          "unit": {
            "$ref": "#/components/schemas/unit"
          }
        },
        "required": [
          "value",
          "unit"
        ]
      },
      "durations": {
        "type": "array",
        "description": "The temporary durations the policy allows, each a { value, unit } (present when temporary access is enabled).",
        "items": {
          "$ref": "#/components/schemas/Model21"
        }
      },
      "AccessDurationsConfig": {
        "type": "object",
        "description": "The policy's access duration options — use them to build a valid `requestedAccessDuration`. See each field for the allowed access types and durations.",
        "example": {
          "permanentAccessEnabled": true,
          "temporaryAccessEnabled": true,
          "durations": [
            {
              "value": 7,
              "unit": "day"
            }
          ],
          "allowRequesterCustomDuration": true
        },
        "properties": {
          "permanentAccessEnabled": {
            "type": "boolean",
            "description": "Whether the policy allows requesting access with no expiration (permanent)."
          },
          "temporaryAccessEnabled": {
            "type": "boolean",
            "description": "Whether the policy allows requesting time-limited (temporary) access."
          },
          "durations": {
            "$ref": "#/components/schemas/durations"
          },
          "allowRequesterCustomDuration": {
            "type": "boolean",
            "description": "Whether the requester may specify a custom duration instead of choosing one of the preset durations."
          }
        },
        "required": [
          "permanentAccessEnabled",
          "temporaryAccessEnabled",
          "durations",
          "allowRequesterCustomDuration"
        ]
      },
      "AccessRequestPolicy": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "example": 1042
          },
          "name": {
            "type": "string",
            "description": "Deprecated. Use `profiles`. Name of the first access profile of the policy",
            "example": "The Seven - Standard Profile Access"
          },
          "description": {
            "type": "string",
            "description": "Deprecated. Use `profiles`. Description of the first access profile of the policy",
            "example": "Standard access for members of The Seven",
            "nullable": true
          },
          "profiles": {
            "$ref": "#/components/schemas/profiles"
          },
          "app": {
            "$ref": "#/components/schemas/app"
          },
          "approvalFlow": {
            "$ref": "#/components/schemas/approvalFlow"
          },
          "provisioningWorkflow": {
            "$ref": "#/components/schemas/provisioningWorkflow"
          },
          "deprovisioningWorkflow": {
            "$ref": "#/components/schemas/deprovisioningWorkflow"
          },
          "eligibilityGroups": {
            "$ref": "#/components/schemas/eligibilityGroups"
          },
          "accessDurationsConfig": {
            "$ref": "#/components/schemas/AccessDurationsConfig"
          }
        },
        "required": [
          "id"
        ]
      },
      "accessRequestPolicies": {
        "type": "array",
        "items": {
          "$ref": "#/components/schemas/AccessRequestPolicy"
        }
      },
      "AccessRequestPolicies": {
        "type": "object",
        "description": "Access Request Policies",
        "properties": {
          "accessRequestPolicies": {
            "$ref": "#/components/schemas/accessRequestPolicies"
          }
        },
        "required": [
          "accessRequestPolicies"
        ]
      },
      "keys": {
        "type": "array",
        "example": [
          "userEmail"
        ],
        "items": {
          "type": "string"
        }
      },
      "validation": {
        "type": "object",
        "description": "When the request itself is malformed: which part of it and which keys were refused",
        "properties": {
          "source": {
            "type": "string",
            "example": "payload"
          },
          "keys": {
            "$ref": "#/components/schemas/keys"
          }
        },
        "required": [
          "source",
          "keys"
        ]
      },
      "Model22": {
        "type": "object",
        "properties": {
          "statusCode": {
            "type": "integer",
            "example": 400,
            "enum": [
              400
            ]
          },
          "error": {
            "type": "string",
            "description": "HTTP status name",
            "example": "Bad Request"
          },
          "message": {
            "type": "string"
          },
          "code": {
            "type": "string"
          },
          "validation": {
            "$ref": "#/components/schemas/validation"
          }
        },
        "required": [
          "statusCode",
          "error",
          "message"
        ]
      }
    }
  },
  "paths": {
    "/appCatalog/accessRequestPolicies": {
      "get": {
        "summary": "List access request policies",
        "operationId": "getAppcatalogAccessrequestpolicies",
        "description": "Returns the organization’s access request policies.<br/><br/>Use the `fields` query parameter to choose which fields to return — e.g. `fields=id,name,app,approvalFlow,eligibilityGroups,accessDurationsConfig`.<br/><br/>\n<p><ul><li>Rate limit: 60 requests per minute</li></ul></p>",
        "parameters": [
          {
            "name": "fields",
            "in": "query",
            "schema": {
              "type": "string",
              "description": "List of fields to return for each policy.<br>Allowed fields: `id`, `name`, `description`, `profiles`, `app`, `approvalFlow`, `provisioningWorkflow`, `deprovisioningWorkflow`, `eligibilityGroups`, `accessDurationsConfig`.<br>`id` is always returned. Defaults to `id`, `name`, `profiles`.",
              "default": "id,name,profiles"
            },
            "description": "List of fields to return for each policy.<br>Allowed fields: `id`, `name`, `description`, `profiles`, `app`, `approvalFlow`, `provisioningWorkflow`, `deprovisioningWorkflow`, `eligibilityGroups`, `accessDurationsConfig`.<br>`id` is always returned. Defaults to `id`, `name`, `profiles`."
          }
        ],
        "tags": [
          "App Catalog"
        ],
        "responses": {
          "200": {
            "description": "Access Request Policies",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccessRequestPolicies"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Model22"
                }
              }
            }
          }
        }
      }
    }
  }
}
```