---
title: "Get an Action instance."
method: GET
path: "/direct/actions/{action_key_value}"
tags: ["Actions"]
---

# Get an Action instance.

`GET /direct/actions/{action_key_value}`

## Request

- Base URL: `https://api.xchange.trimble.com/connect/v1`
- URL: `https://api.xchange.trimble.com/connect/v1/direct/actions/{action_key_value}`
- Auth: none required

## Path parameters

- `action_key_value` string, required

## Headers

- `X-Application-Key` string, required

## Response `200`

Success

- object
  - `id` string: Action Identifier
  - `data` object: Contains the input object to the Action POST call.
  - `dataObjectCode` string: Data Object Code
  - `actionCode` string: Action Code
  - `subscriberCode` string: Subscriber Code
  - `createdUtc` string: Action Created Date
  - `status` 'Queued' | 'Processing' | 'Failed' | 'Successful': Action Status
  - `result` string: This object definition is defined on each Action POST. See Responses: "x-$.result for Successful" and "x-$.result for Failed" for the specific action based on the $.dataObjectCode and $.actionCode properties.

## Other responses

- `401`: You have not provided a proper X-Application-Key in the header of this request.
- `403`: The X-Application-Key provided is valid but the key does not have access to this resource.
- `404`: The object with the given ID was not found OR a subscriber with the given URL was not found.

---

[API](https://skmtc.dev/trimble/apis/vista-job-cost-v2-direct-api.md) - [All operations](https://skmtc.dev/trimble/apis/vista-job-cost-v2-direct-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trimble/apis/vista-job-cost-v2-direct-api/revisions/87f37ccfa1b0?raw)