---
title: "Get pending approvals requests where you are an approver."
method: GET
path: "/approvals"
tags: ["approvals"]
---

# Get pending approvals requests where you are an approver.

`GET /approvals`

## Request

- Base URL: `https://api.smartrecruiters.com/approvals-api/v201910`
- URL: `https://api.smartrecruiters.com/approvals-api/v201910/approvals`
- Auth: one of:
  - API key in header `x-smarttoken`
  - OAuth 2
    - Authorization code: `https://www.smartrecruiters.com/identity/oauth/allow`
    - Token URL: `https://api.smartrecruiters.com/identity/oauth/token` scopes: `approvals_read`

The max number of returned approval requests is 100.

## Query parameters

- `pageId` string

## Response `200`

Approval requests

- ApprovalRequests: Approval requests
  - `content` ApprovalRequest[]
    - `id` string: Approval request id
    - `subject` Subject: Subject of approval request
      - `id` string
      - `type` 'job' | 'offer'
    - `type` 'sequential' | 'parallel'
    - `decisionMode` 'any' | 'all'
    - `status` 'PENDING' | 'APPROVED' | 'REJECTED' | 'ABANDONED': Status of approval request
    - `steps` Step[]
      - `status` 'PENDING' | 'APPROVED' | 'REJECTED' | 'SKIPPED': Status of approval step
      - `approvers` Approver[]: The order matters when type is `sequential`
        - `id` string: Approver id
        - `decision` 'PENDING' | 'APPROVED' | 'REJECTED' | 'SKIPPED': Decision status for approver
        - `decidedOn` string, date-time: Decision date

## Other responses

- `400`: Unable to retrieve approval requests with codes * **INVALID_PAGE_ID** when pageId is incorrect

---

[API](https://skmtc.dev/smartrecruiters/apis/approvals-api.md) - [All operations](https://skmtc.dev/smartrecruiters/apis/approvals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smartrecruiters/apis/approvals-api/revisions/19e2c88e92b5?raw)