---
title: "Get terminal action"
method: GET
path: "/companies/{companyId}/terminalActions/{actionId}"
tags: ["Terminal actions - company level"]
---

# Get terminal action

`GET /companies/{companyId}/terminalActions/{actionId}`

## Request

- Base URL: `https://management-test.adyen.com/v3`
- URL: `https://management-test.adyen.com/v3/companies/{companyId}/terminalActions/{actionId}`
- Auth: one of:
  - HTTP basic
  - API key in header `X-API-Key`

Returns the details of the [terminal action](https://docs.adyen.com/point-of-sale/automating-terminal-management/terminal-actions-api) identified in the path.
To make this request, your API credential must have one of the following [roles](https://docs.adyen.com/development-resources/api-credentials#api-permissions):
* Management API—Terminal actions read
* Management API—Terminal actions read and write

In the live environment, requests to this endpoint are subject to [rate limits](https://docs.adyen.com/point-of-sale/automating-terminal-management#rate-limits-in-the-live-environment).

## Path parameters

- `companyId` string, required
- `actionId` string, required

## Response `200`

OK - the request has succeeded.

- ExternalTerminalAction
  - `actionType` string: The type of terminal action: **InstallAndroidApp**, **UninstallAndroidApp**, **InstallAndroidCertificate**, or **UninstallAndroidCertificate**.
  - `config` string: Technical information about the terminal action.
  - `confirmedAt` string, date-time: The date and time when the action was carried out.
  - `id` string: The unique ID of the terminal action.
  - `result` string: The result message for the action.
  - `scheduledAt` string, date-time: The date and time when the action was scheduled to happen.
  - `status` string: The status of the terminal action: **pending**, **successful**, **failed**, **cancelled**, or **tryLater**.
  - `terminalId` string: The unique ID of the terminal that the action applies to.

## Other responses

- `400`: Bad Request - a problem reading or understanding the request.
- `401`: Unauthorized - authentication required.
- `403`: Forbidden - insufficient permissions to process the request.
- `422`: Unprocessable Entity - a request validation error.
- `500`: Internal Server Error - the server could not process the request.

---

[API](https://skmtc.dev/adyen/apis/management-api.md) - [All operations](https://skmtc.dev/adyen/apis/management-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adyen/apis/management-api/revisions/55cb8143ce0e?raw)
