---
title: "Retrieve a paginated list of invoice approval policies"
method: GET
path: "/approval-policies"
tags: ["approvalPolicies"]
---

# Retrieve a paginated list of invoice approval policies

`GET /approval-policies`

Returns a paginated list of invoice approval policies visible to the authenticated user. Used by partners to audit or sync policy configuration.

## Query parameters

- `page` integer
- `limit` integer
- `search` string
- `level_type` string
- `is_enabled` boolean
- `ottimate_location_id` integer
- `has_missing_approver` boolean

## Headers

- `Authorization` string, required
- `X-Api-Key` string, required
- `X-API-Version` string

## Response `200`

Successful response with paginated policy list

- ApprovalPoliciesGetApprovalPoliciesRootResponse200 — Empty response body

## Other responses

- `401` — Unauthorized - Authentication required or invalid credentials
- `403` — Forbidden - Access denied or insufficient permissions

## Changes

> 11 revisions in range; 3 could not be searched.

- **2026-08-22** `75aab60eedc9` — 3 warning
  - for the `query` request parameter `limit`, the max was set to `100.00`
  - for the `query` request parameter `limit`, the min was set to `1.00`
  - for the `query` request parameter `page`, the min was set to `1.00`
- **2026-08-19** `c0b5cf6c7a72` — 1 info
  - endpoint added
- **2026-08-17** `c231509a03cf` — 1 breaking
  - api path removed without deprecation
- **2026-08-13** `1f089f3e34d9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/ottimate/apis/api-reference/changes/approval-policies/get.md)

---

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