> For the complete documentation index, see [llms.txt](https://docs.ebbot.ai/ebbot-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/get-item.md).

# Get Easit Items (Legacy Integration API)

Read an existing Easit Integration API Item View by its identifier and optional idFilter. New workflows should use the GraphQL item actions.

**Action identifier:** `get_item`.

### Inputs

| Field                  | Type           | Required/default | Meaning                                                                                               |
| ---------------------- | -------------- | ---------------- | ----------------------------------------------------------------------------------------------------- |
| `item_view_identifier` | string         | Required         | The System Name of the Item View (found in Design Studio -> Item Views)                               |
| `id_filter`            | string \| null | `null`           | Optional Integration API idFilter (often an internal id:version value, not the visible ticket number) |

### Output

Paths are relative to this action's output. Select them from the builder's variable picker rather than typing them. A field that is null or empty was not returned by Easit; it is not proof that the value is empty in Easit.

| Path                 | Type             | Meaning                                                    |
| -------------------- | ---------------- | ---------------------------------------------------------- |
| `items`              | array of objects | Items returned by the Item View and optional filter.       |
| `items[].id`         | string           | Item identifier returned by the Integration API Item View. |
| `items[].properties` | object           | Item View property names mapped to string values.          |
| `total`              | integer          | Number of items returned in this result.                   |

### Declared errors

Instead of the output above, the action can return one of these objects. Check for them before using the output in a later step.

#### `ItemNotFound`

| Path        | Type    | Meaning                                            |
| ----------- | ------- | -------------------------------------------------- |
| `exists`    | boolean | False when no matching item or field was found.    |
| `id_filter` | string  | Integration API filter that did not match an item. |

### Behavior and limits

Reads an existing Easit Integration API Item View. Supply `item_view_identifier`, the Item View's system name from Design Studio. Optional `id_filter` is passed as `idFilter`; it is often an internal `id:version` value and is not necessarily the visible ticket number.

Returns `items`, each with a string `id` and a property map, plus `total` for the returned items. An unmatched filter returns declared `ItemNotFound`. API failures can propagate as HTTP errors.

The fallback for inconsistent Easit filtering examines only the first 200 Item View results. Use [**Get Easit Item (GraphQL)**](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/get-item-graphql.md) or [**Find Easit Item by Ticket Number**](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions/find-item-by-ticket-number.md) for new workflows. Requires access to the configured Item View.

See [Troubleshooting](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/troubleshooting.md), or return to the [action catalog](https://docs.ebbot.ai/ebbot-docs/integrations/automations-integrations/integration-setup-guides/easit-integration-in-automations/actions.md).
