---
title: "Get approval requests"
method: GET
path: "/approval_requests"
tags: ["Approval requests"]
---

# Get approval requests

`GET /approval_requests`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/approval_requests`
- Auth: HTTP bearer

## Query parameters

- `order` 'asc' | 'desc'
- `limit` integer
- `pagination_token` string
- `sort` 'created_at' | 'updated_at'
- `created_at__gt` string, date-time
- `created_at__lt` string, date-time
- `created_at__gte` string, date-time
- `created_at__lte` string, date-time
- `updated_at__gt` string, date-time
- `updated_at__lt` string, date-time
- `updated_at__gte` string, date-time
- `updated_at__lte` string, date-time
- `object_id` string, uuid
- `object_id__in` string, uuid
- `status` 'waiting' | 'approved' | 'rejected' | 'canceled'
- `status__in` 'waiting' | 'approved' | 'rejected' | 'canceled'
- `user_id` string, uuid
- `role_id` string, uuid
- `object_type` 'account' | 'approval' | 'approval_request' | 'approval_policy' | 'approval_policy_process' | 'audit_trail' | 'comment' | 'counterpart' | 'counterpart_address' | 'counterpart_bank_account' | 'counterpart_contact_person' | 'counterpart_partner_metadata' | 'counterpart_tax_id' | 'counterpart_vat_id' | 'delivery_note' | 'einvoicing' | 'entity' | 'entity_bank_account' | 'entity_settings' | 'entity_token' | 'entity_user' | 'entity_user_token' | 'entity_vat_ids' | 'export' | 'mailbox' | 'monitescript_process' | 'ocr_task' | 'onboarding' | 'overdue_reminder' | 'partner' | 'partner_internal_config' | 'partner_settings' | 'partner_token' | 'payable' | 'payable_line_item' | 'payables_credit_note' | 'payables_purchase_order' | 'payment' | 'payment_intent' | 'payment_link' | 'payment_record' | 'payment_reminder' | 'person' | 'product' | 'project' | 'receivable' | 'reconciliation' | 'recurrence' | 'receipt' | 'role' | 'tag' | 'todo_task' | 'todo_task_mute' | 'transaction' | 'webhook' | 'workflow' | 'workflow_pipeline'
- `object_type__in` 'account' | 'approval' | 'approval_request' | 'approval_policy' | 'approval_policy_process' | 'audit_trail' | 'comment' | 'counterpart' | 'counterpart_address' | 'counterpart_bank_account' | 'counterpart_contact_person' | 'counterpart_partner_metadata' | 'counterpart_tax_id' | 'counterpart_vat_id' | 'delivery_note' | 'einvoicing' | 'entity' | 'entity_bank_account' | 'entity_settings' | 'entity_token' | 'entity_user' | 'entity_user_token' | 'entity_vat_ids' | 'export' | 'mailbox' | 'monitescript_process' | 'ocr_task' | 'onboarding' | 'overdue_reminder' | 'partner' | 'partner_internal_config' | 'partner_settings' | 'partner_token' | 'payable' | 'payable_line_item' | 'payables_credit_note' | 'payables_purchase_order' | 'payment' | 'payment_intent' | 'payment_link' | 'payment_record' | 'payment_reminder' | 'person' | 'product' | 'project' | 'receivable' | 'reconciliation' | 'recurrence' | 'receipt' | 'role' | 'tag' | 'todo_task' | 'todo_task_mute' | 'transaction' | 'webhook' | 'workflow' | 'workflow_pipeline'
- `created_by` string, uuid

## Headers

- `x-monite-version` string, required
- `x-monite-entity-id` string, required

## Response `200`

Successful Response

- ApprovalRequestResourceList
  - `data` ApprovalRequestResourceWithMetadata[], required
    - `id` string, uuid, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `approved_by` string[], required
    - `created_by` string, uuid, required: ID of the user who created the approval request
    - `object_id` string, uuid, required
    - `object_type` 'account' | 'approval' | 'approval_request' | 'approval_policy' | 'approval_policy_process' | 'audit_trail' | 'comment' | 'counterpart' | 'counterpart_address' | 'counterpart_bank_account' | 'counterpart_contact_person' | 'counterpart_partner_metadata' | 'counterpart_tax_id' | 'counterpart_vat_id' | 'delivery_note' | 'einvoicing' | 'entity' | 'entity_bank_account' | 'entity_settings' | 'entity_token' | 'entity_user' | 'entity_user_token' | 'entity_vat_ids' | 'export' | 'mailbox' | 'monitescript_process' | 'ocr_task' | 'onboarding' | 'overdue_reminder' | 'partner' | 'partner_internal_config' | 'partner_settings' | 'partner_token' | 'payable' | 'payable_line_item' | 'payables_credit_note' | 'payables_purchase_order' | 'payment' | 'payment_intent' | 'payment_link' | 'payment_record' | 'payment_reminder' | 'person' | 'product' | 'project' | 'receivable' | 'reconciliation' | 'recurrence' | 'receipt' | 'role' | 'tag' | 'todo_task' | 'todo_task_mute' | 'transaction' | 'webhook' | 'workflow' | 'workflow_pipeline', required
    - `rejected_by` string, uuid
    - `required_approval_count` integer, required
    - `role_ids` string[], required
    - `status` 'waiting' | 'approved' | 'rejected' | 'canceled', required
    - `user_ids` string[], required
  - `next_pagination_token` string: A token that can be sent in the `pagination_token` query parameter to get the next page of results, or `null` if there is no next page (i.e. you've reached the last page).
  - `prev_pagination_token` string: A token that can be sent in the `pagination_token` query parameter to get the previous page of results, or `null` if there is no previous page (i.e. you've reached the first page).

## Other responses

- `400`: Bad Request
- `401`: The `Authorization` header is missing or contains an invalid or expired access token. See [Authentication](https://docs.monite.com/api/concepts/authentication) to learn how to authenticate API calls.
- `403`: The specified access token does not have permissions to perform this operation.
- `406`: Not Acceptable
- `422`: Validation Error
- `429`: API rate limit has been exceeded. Check the response headers for the rate limit information.

---

[API](https://skmtc.dev/monite/apis/monite-2.md) - [All operations](https://skmtc.dev/monite/apis/monite-2/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-2/revisions/4299ccf95edb?raw)