---
title: "Batch check permissions"
method: POST
path: "/relation-tuples/batch/check"
tags: ["permission"]
---

# Batch check permissions

`POST /relation-tuples/batch/check`

To learn how relationship tuples and the check works, head over to [the documentation](https://www.ory.com/docs/keto/concepts/api-overview).

## Query parameters

- `max-depth` integer

## Request body

- BatchCheckPermissionBody — Batch Check Permission Body
  - `tuples` Relationship[]
    - `namespace` string, required — Namespace of the Relation Tuple
    - `object` string, required — Object of the Relation Tuple
    - `relation` string, required — Relation of the Relation Tuple
    - `subject_id` string — SubjectID of the Relation Tuple Either SubjectSet or SubjectID can be provided.
    - `subject_set` SubjectSet
      - `namespace` string, required — Namespace of the Subject Set
      - `object` string, required — Object of the Subject Set
      - `relation` string, required — Relation of the Subject Set

## Response `200`

batchCheckPermissionResult

- BatchCheckPermissionResult — Batch Check Permission Result
  - `results` CheckPermissionResultWithError[], required — An array of check results. The order aligns with the input order.
    - `allowed` boolean, required — whether the relation tuple is allowed
    - `error` string — any error generated while checking the relation tuple

## Other responses

- `400` — errorGeneric
- `default` — errorGeneric

## Changes

- **2024-07-18** `86d69b76726d` — 1 info
  - endpoint added
- **2021-10-07** `e90046dbd055` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/ory/apis/ory-keto-api/changes/relation-tuples/batch/check/post.md)

---

[API](https://skmtc.dev/ory/apis/ory-keto-api.md) · [All operations](https://skmtc.dev/ory/apis/ory-keto-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ory/ory-keto-api/revisions/4e980fe4b29b/schema)