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 \
     -d ottimate_company_id=15196

{
  "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": [
        {
          "id": "1001",
          "account_id": "2001",
          "name": "Restaurant Manager",
          "escalation_days": null,
          "user_ids": [
            12346
          ],
          "approvers": [
            {
              "id": 12346,
              "email": "jane.smith@example.com",
              "first_name": "Jane",
              "last_name": "Smith"
            }
          ]
        }
      ]
    }
  ]
}

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, starting at 1. Requesting a page past the last one returns 404.

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

policy_setenumOptional

Which set of policies to list. Omitted returns single-scope policies only — what every existing integration receives today. advanced returns multi-scope policies, whose scope is reported in scope rather than in the single-scope fields.

Allowed values:

ottimate_company_idintegerOptional

Filter to policies scoped to (owning) this company

Response

Successful response with paginated policy list

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

Authentication

Headers

Query parameters

Response

Errors