---
title: "Get approval request by id"
method: GET
path: "/approvals/{approvalRequestId}"
tags: ["approvals"]
---

# Get approval request by id

`GET /approvals/{approvalRequestId}`

## Request

- Base URL: `https://api.smartrecruiters.com/approvals-api/v201910`
- URL: `https://api.smartrecruiters.com/approvals-api/v201910/approvals/{approvalRequestId}`
- 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`

## Path parameters

- `approvalRequestId` string, required

## Response `200`

Found approval request

- ApprovalRequest: Approval request
  - `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

- `404`: with code * **APPROVAL_REQUEST_NOT_FOUND** when approval request is not found

---

[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)