# API Integration Guide

## v1.5.0

Custom Coloring and Partial Coloring features are introduced in the v1.5.0 release.

{% embed url="<https://github.com/atomicals/atomicals-electrumx/releases/tag/v1.5.0.0-beta.1>" %}

These features also introduce the breaking change to the result when reading the Atomicals assets.

When you are requesting the list (typically `blockchain.atomicals.listscripthash` ), the structure  `response.utxos.atomicals` has been updated.

#### Before

The field's type was a string list that contained the Atomical ID in that UTXO.

```json
{
  "atomicals": [
    "9025f03bcf9325f6071761b9aee00b462a0b43ed157c336e2e89e07f47ea6f66i0"
  ],
  "height": 847000,
  "index": 0,
  "txid": "b3ab9bf07db9075c1bbdef5638aef4941564a8afa3e0399ea4127285796b9ac1",
  "value": 546,
  "vout": 0
}
```

#### After

The field's type is a record map that contains the Atomical ID and the corresponding Atomicals value in that UTXO.

```json
{
  "atomicals": {
    "9025f03bcf9325f6071761b9aee00b462a0b43ed157c336e2e89e07f47ea6f66i0": 546
  },
  "height": 847000,
  "index": 0,
  "txid": "b3ab9bf07db9075c1bbdef5638aef4941564a8afa3e0399ea4127285796b9ac1",
  "value": 546,
  "vout": 0
}
```

Now the Atomicals value might not equal the UTXO value, so you shall read based on the Atomical ID to obtain the correct value.
