# Query a single attribute

Use the `getAttributes()` function from the [QuadReader](https://docs.quadrata.com/integration/additional-information/smart-contracts) smart contract to query a single attribute about a passport holder.

### Requirements

#### Installation

Install ***@quadrata/contracts*** package

```
npm i @quadrata/contracts --save-dev
```

#### Permissions

Calling smart contract have to be granted permissions to call `getAttributes` in Mainnet.\
Contact us via email at <contact@quadrata.com> or [Discord](https://discord.gg/wnJQBvwzds)

{% hint style="info" %}
Testnets like Goerli,Mumbai,etc.. do not require any permissions
{% endhint %}

### Function

{% code title="QuadReader.sol" %}

```solidity
import "@quadrata/contracts/interfaces/IQuadPassportStore.sol";

// For Solidity version >= 0.8.0.
reader.getAttributes(
    address user, 
    bytes32 attribute
) external payable returns(
    IQuadPassportStore.Attribute[] memory attributes
);


// For Solidity version < 0.8.0.
reader.getAttributesLegacy(
    address user, 
    bytes32 attribute
) external payable returns(
    bytes32[] attributeValues, 
    uint256[] epochs, 
    address[] issuers
);
```

{% endcode %}

#### Parameters

<table><thead><tr><th width="192.33333333333331">Parameter</th><th>Description</th><th>Type</th></tr></thead><tbody><tr><td>user</td><td>address of the passport holder</td><td>address (required)</td></tr><tr><td>attribute</td><td>The attribute you want to query. See: <a href="../../../introduction/passport-attributes">Supported attributes</a>. </td><td>bytes32 (required)</td></tr></tbody></table>

#### Return values

A list of attributes that have been issued.

{% code title="IQuadPassportStore.sol" %}

```solidity
/// @dev Attribute store infomation as it relates to a single attribute
/// `attrKeys` Array of keys defined by (wallet address/DID + data Type)
/// `value` Attribute value
/// `epoch` timestamp when the attribute has been verified by an Issuer
/// `issuer` address of the issuer issuing the attribute
struct Attribute {
    bytes32 value;
    uint256 epoch;
    address issuer;
}
```

{% endcode %}

{% hint style="info" %}
`For Solidity version < 0.8.0`

`Use`**`getAttributesLegacy()`**`which` returns three arrays. The index of each array maps to the others to create a tuple (e.g. `attributeValues[0]`, `epochs[0]`, `issuers[0]` are part of the same result).&#x20;

* **attributeValues**: Raw or hashed attribute values. See [Supported attributes](https://docs.quadrata.com/integration/introduction/passport-attributes) for the return values of each attribute.&#x20;
* **epochs:** Timestamp that indicates when the attribute was verified by the passport issuer.&#x20;
* **issuers:** Passport issuer who verified the attributes.
  {% endhint %}

### Example

{% hint style="success" %}
You can find our helper library to facilitate parsing the response => [QuadReaderUtils](https://docs.quadrata.com/integration/how-to-integrate/query-attributes/via-smart-contract/query-helper)
{% endhint %}

```solidity
import "@quadrata/contracts/interfaces/IQuadReader.sol";
import "@quadrata/contracts/interfaces/IQuadPassportStore.sol";
import "@quadrata/contracts/utility/QuadReaderUtils.sol";

contract MyDapp {
    using QuadReaderUtils for bytes32;
    IQuadReader public reader;
    
    function borrowMoney() external payable {
        IQuadPassportStore.Attribute[] memory attributes = reader.getAttributes(
            msg.sender, 
            keccak256("COUNTRY")
        );

        require(attributes.length > 0, "REQUIRES_COUNTRY");
        
        // only users residing outside the US may borrow money        
        if (!attributes[0].value.countryIsEqual("US")) {
            // Allow borrow actions
        }
    }

```

####