# Command 0xD101 - Get Property

The host uses this command to get information about the device or its configuration / settings.

Each data element representing device information or device configuration is part of a tree of values and is uniquely identified by an Object Identifier (also known as an Object ID or OID) as defined in ITU-T X.660 | ISO/IEC 9834-1, which can be found by searching for X.660 in the publications on <http://www.itu.int/>. This document refers to these data elements collectively as **Properties**. The list of all properties and their corresponding OIDs and other characteristics is provided in section **8 Configuration**.

This command can be used in multiple ways. For simplicity, this document describes one possible way that does not require detailed knowledge of the X.660 specification.

To get a property, the sequence of events is as follows:

{% stepper %}
{% step %}

### Determine the property or branch

The host determines which property or tree branch of properties it wants to get from the device (see section **8 Configuration**).
{% endstep %}

{% step %}

### Compose and send the request

The host composes the command request in the format below, and sends it to the device.
{% endstep %}

{% step %}

### Receive the response

The device sends a response. If the request succeeded, the response includes the value(s) of the requested property or properties. If it did not succeed, the device returns a failure response with no command-specific parameters.
{% endstep %}
{% endstepper %}

## Table - Request Data for Command 0xD101 - Get Property

<table><thead><tr><th>Tag</th><th width="74.33331298828125">Len</th><th width="244">Value / Description</th><th width="73.33331298828125">Typ</th><th width="75.3333740234375">Req</th><th width="96.6666259765625">Default</th></tr></thead><tbody><tr><td>Beginning of any wrappers, at minimum including <strong>Request Message</strong> </td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>D101 = <strong>Command 0xD101 - Get Property</strong></td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>81</td><td>var</td><td>Company ID This value is the root of the “long form” of the Property OID, and is the same for all MagTek devices. Leave this parameter empty and use the default.</td><td>B</td><td>O</td><td>2B 06 01 04 01 F6 09</td></tr><tr><td>82</td><td>03</td><td><p>This value is the second portion of the “long form” of the Property OID, and is the same for all similar MagTek devices within the same product family. Unless you have a specific use case that uses this parameter, leave this parameter empty and use the default otherwise your software may not work with multiple products. Byte 1 Platform</p><ul><li>0x02 = Apollo Platform</li></ul><p>Byte 2 Product</p><ul><li>0x01 = DynaFlex, 0x02 = DynaProx, 0x03 = DynaFlex II PED, 0x04 = DynaFlex II, 0x05 = DynaFlex II Go</li></ul><p>Byte 3 Device Variant</p><ul><li>0x00 = Standard</li></ul></td><td>B</td><td>O</td><td>Product dependent</td></tr><tr><td>85</td><td>01</td><td><p>Property Type This parameter contains the first number of the Property OID as documented in section <strong>8 Configuration</strong>.</p><ul><li>0x01 = Device Settings</li><li>0x02 = Device Information</li></ul></td><td>B</td><td>R</td><td></td></tr><tr><td>87</td><td>var</td><td>Property OID Tree Prefix This optional parameter contains subsequent numbers of the Property’s OID as documented in section <strong>8 Configuration</strong>, but can not include the final number. This can also be populated with fewer numbers from the OID, in which case the remaining numbers of the OID of the Property or set of Properties you wish to retrieve must be included in the <strong>Property OID Remainder</strong>. For simplicity, populate this with the 2nd through the second-to-last number in the property’s OID.</td><td>B</td><td>O</td><td>Null</td></tr><tr><td>89</td><td>var</td><td>Property OID Remainder This contains the remaining numbers of the Property’s OID, BER TLV encoded per X.660 section <em>8 Basic encoding rules</em>. For details about TLV encoding an OID. To request a set of properties in a branch of the Property OID structure, the host should pass a partial Property OID, and the device returns the value of all properties from the specified tree level downward. For simplicity, include all numbers except the final number of the property’s OID in <strong>Property Type</strong> and <strong>Property OID Tree Prefix</strong>, and include the final number of the OID OR 0xC0 here, then append constant byte 0x00. These two bytes represent a single empty BER TLV primitive data object.</td><td>B</td><td>R</td><td></td></tr><tr><td>End of any wrappers, at minimum including <strong>Request Message</strong> </td><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>

## Table - Response Data for Command 0xD101 - Get Property

<table><thead><tr><th width="216.66668701171875">Tag</th><th width="72.33331298828125">Len</th><th width="244.66668701171875">Value / Description</th><th width="74.66668701171875">Typ</th><th width="74.6666259765625">Req</th><th width="97.3333740234375">Default</th></tr></thead><tbody><tr><td>Beginning of any wrappers, at minimum including <strong>Response Message</strong></td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>D101 = <strong>Command 0xD101 - Get Property</strong></td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>81</td><td>var</td><td>Company ID This contains the Company ID the host included in the request message. If this parameter is not included in the request, the response does not include it.</td><td>B</td><td>O</td><td>N/A</td></tr><tr><td>82</td><td>03</td><td>Device Family ID This contains the Device Family ID the host included in the request message. If this parameter is not included in the request, the response does not include it.</td><td>B</td><td>O</td><td>N/A</td></tr><tr><td>85</td><td>01</td><td>Property Type This contains the Property Type the host included in the request message.</td><td>B</td><td>R</td><td>N/A</td></tr><tr><td>87</td><td>var</td><td>Property OID Tree Prefix This contains the Property OID Tree Prefix the host included in the request message. If this parameter is not included in the request, the response does not include it.</td><td>B</td><td>O</td><td>N/A</td></tr><tr><td>89</td><td>var</td><td><p>Property OID Remainder This contains the same TLV-encoded portion of the OID the host included in the Property OID Remainder of the request message, with leaf nodes populated with actual values. If the host requested a set of properties in a branch of the Property OID structure, this contains the set of requested branches, including branch OIDs, leaf node IDs, and values. If the host follows the “for simplicity” recommendation in the request message to request a single property, it can retrieve the value of the requested property by stripping off the first few bytes, which represent the TLV-encoded last number in the OID and the length of the property’s value, as follows; the remaining bytes are the value of the property:</p><ul><li>If the second byte is 7F or less, strip off the first two bytes.</li><li>If the second byte is 81, strip off the first three bytes.</li><li>If the second byte is 82, strip off the first four bytes.</li></ul></td><td>B</td><td>R</td><td>N/A</td></tr><tr><td>End of any wrappers, at minimum including <strong>Response Message</strong> </td><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>

If the request started successfully, the Request Status in the message wrapper is **OK, Started / Running, All good / requested operation was successful**.

## Table - Request Example

| Example (Hex)                                                                                                                                                                                                                                                                                                                                                                                                                           |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Get [**Property 1.2.7.1.1.1 Device Reset Occurred Notification Contro**](https://magtek.gitbook.io/magtek-pilot-gitbooks/internal-documentation/index/8.0-configuration/8.3-property-group-1.2.nnnn-device-settings/8.3.7-property-subgroup-1.2.7.nnn-system-settings#table-994-property-1.2.7.1.1.1-device-reset-occurred-notification-control)**l** using “simple” form: AA00 8104 0155D101 840F D101 8501 01 8704 02070101 8902 C100 |

## Table - Response Example

| Example (Hex)                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Get [**Property 1.2.7.1.1.1 Device Reset Occurred Notification Control**](https://magtek.gitbook.io/magtek-pilot-gitbooks/internal-documentation/index/8.0-configuration/8.3-property-group-1.2.nnnn-device-settings/8.3.7-property-subgroup-1.2.7.nnn-system-settings#table-994-property-1.2.7.1.1.1-device-reset-occurred-notification-control) using “simple” form: AA00 8104 8255D101 8204 00000000 84820010 D101 8501 01 8704 02070101 8903 C101 00 |

## Table - Request Example

| Example (Hex)                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Get [**Property 1.2.7.1.1.1 Device Reset Occurred Notification Control**](https://magtek.gitbook.io/magtek-pilot-gitbooks/internal-documentation/index/8.0-configuration/8.3-property-group-1.2.nnnn-device-settings/8.3.7-property-subgroup-1.2.7.nnn-system-settings#table-994-property-1.2.7.1.1.1-device-reset-occurred-notification-control) using longer Property OID Remainder: AA00 8104 0155D101 8411 D101 8501 01 890A E208 E706 E104 E102 C100 |

## Table - Response Example

| Example (Hex)                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Get [**Property 1.2.7.1.1.1 Device Reset Occurred Notification Control**](https://magtek.gitbook.io/magtek-pilot-gitbooks/internal-documentation/index/8.0-configuration/8.3-property-group-1.2.nnnn-device-settings/8.3.7-property-subgroup-1.2.7.nnn-system-settings#table-994-property-1.2.7.1.1.1-device-reset-occurred-notification-control) using longer Property OID Remainder: AA00 8104 8255D101 8204 00000000 84820012 D101 8501 01 890B E209 E707 E105 E103 C101 00 |

## Table - Request Example

| Example (Hex)                                                                                                                                                                                                                                                                                                                                                                       |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Get [**Property Subgroup 2.1.2.2.nn Core Firmware Information**](https://magtek.gitbook.io/magtek-pilot-gitbooks/internal-documentation/index/8.0-configuration/8.5-property-group-2.1.2.nnn-device-firmware-identification-information/8.5.2-property-subgroup-2.1.2.2.nn-core-firmware-information) using “simple” form: AA00 8104 0155D101 840D D101 8501 02 8702 0102 8902 C200 |

## Table - Response Example

| Example (Hex)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <p>Get <a href="https://magtek.gitbook.io/magtek-pilot-gitbooks/internal-documentation/index/8.0-configuration/8.5-property-group-2.1.2.nnn-device-firmware-identification-information/8.5.2-property-subgroup-2.1.2.2.nn-core-firmware-information"><strong>Property Subgroup 2.1.2.2.nn Core Firmware Information</strong></a> using “simple” form: </p><p></p><p>AA00 81 04 8255D101 82 04 00000000 84 820056 D101 85 01 02 87 02 0102 89 820049 E2 820045 E1 820004 C1 00 C2 00 E2 820039 C1 0D 44796E61466C65782050726F00 C2 13 313030303030373138332D41352D5043490000 C3 00 C4 0B 3130303030303731383300 C5 00 C6 02 FF00</p> |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.magtek.com/hardware/card-readers/mms-dyna-devices/emv-common-kernel/dynaflex-ii-go/dynaflex-ii-go-document-drafts/programmers-manuals/programmers-manuals-commands/commands/command-group-0xd1nn-settings-and-information/command-0xd101-get-property.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
