> ## Documentation Index
> Fetch the complete documentation index at: https://docs.argyle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API enhancements

> New mapping_status Item fields introduced.

<div className="release-meta">
  <span className="release-date">May 16, 2023</span>
  <span className="release-tag" data-changelog-tag="api">API</span>
</div>

<img src="https://mintcdn.com/argyle/spW0uZwUC4bDyMgL/images/changelog-generic/api.png?fit=max&auto=format&n=spW0uZwUC4bDyMgL&q=85&s=1537fc09ccdfb211eeafbc1178e91f0b" alt="API update illustration" width="1030" height="290" data-path="images/changelog-generic/api.png" />

When [retrieving an Item by its ID](https://argyle.com/docs/api-reference/items#retrieve), a new `mapping_status` field is now returned with three possible values:

* `verified` — The payroll system associated with the Item is known, and the Item has previously experienced a successful connection.
* `mapped` — The payroll system associated with the Item is known, but the Item is awaiting a successful connection.
* `unmapped` — The payroll system associated with this Item is not yet known. If an unmapped Item is selected in Link, the user will be given the option to search for the relevant payroll system and attempt to connect using their login credentials.

Changes to an Item's `mapping_status` value will result in a new Item notification and cause the [items.updated webhook](https://argyle.com/docs/api-reference/items-webhooks#updated) to be sent.
