Retrieve a paginated list of invoice approval policies

curl -G https://api.ottimate.com/v1/approval-policies \
     -H "X-Api-Key: your-api-key-here" \
     -H "X-API-Version: 1.0.0" \
     -H "Authorization: Bearer <token>" \
     -d page=1 \
     -d limit=20

{
  "version": "1.0.0",
  "count": 1,
  "page": 1,
  "limit": 20,
  "results": [
    {
      "id": "plcy_7d27b39042ab11f09213577c0b92a500",
      "name": "Manager Approval — Over $500",
      "min_users_for_approval": 1,
      "has_missing_approver": false,
      "is_enabled": true,
      "use_buyer_approver": false,
      "group": null,
      "restaurant": {
        "id": 456,
        "name": "Main Kitchen"
      },
      "company": null,
      "account": null,
      "bank_account": null,
      "user_approvers": [
        {
          "id": 12346,
          "username": "jsmith",
          "email": "jane.smith@example.com",
          "first_name": "Jane",
          "last_name": "Smith",
          "phone": null,
          "is_active": true,
          "display_name": "Jane Smith",
          "escalation_days": null,
          "replacement": null
        }
      ],
      "role_approvers": []
    }
  ]
}

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

Authentication

AuthorizationBearer

OAuth2 authentication flows. Auth server URLs will vary by environment

Query parameters

pageintegerOptional>=1Defaults to 1

Page number for pagination

limitintegerOptional1-100Defaults to 20

Number of items per page

searchstringOptional

Search by policy name, purpose, or owner name

level_typestringOptional

Comma-separated owner scope: company, account, group, location, bank_account

is_enabledbooleanOptional

Filter enabled/disabled policies

ottimate_location_idintegerOptional

Filter to policies scoped to (owning) this location

has_missing_approverbooleanOptional

Filter to policies with (or without) a missing-approver warning — supports health-dashboard use cases

Response

Successful response with paginated policy list

Errors

401

Unauthorized Error

403

Forbidden Error

Authentication

Headers

Query parameters

Response

Errors