---
title: "Returns the permissions bundle"
method: GET
path: "/permissions-bundle"
tags: ["permissions"]
---

# Returns the permissions bundle

`GET /permissions-bundle`

## Request

- Base URL: `/v1` (relative, and the document’s source URL is not known)
- URL: `/v1/permissions-bundle`
- Auth: none required

Returns the permissions bundle, an optimised format for evaluating permissions

## Response `200`

Successfully retrieved the permissions bundle

- Bundle: A map of permission ID to entity lookup map

## Other responses

- `400`: Invalid request
- `401`: Unauthorised request
- `403`: User is unauthorised for this role
- `500`: Failed to process the request due to an internal error

---

[API](https://skmtc.dev/office-of-national-statistics/apis/permissions-api.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/permissions-api/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/permissions-api/revisions/c0050251683f?raw)