---
description: >-
  After receiving a notification, you need to GET the release in order to
  receive the latest data.
---

# Fetch latest data after receiving event notification.

**EXAMPLE:**

{% code title="webhook" %}
```json
{
    "release": "0x24Fc2D465AaAbf47DA7284920A7B5c3b368EC1D9",
    "event": "TRANSFER",
    "organization": "0x78f13e5253a30f0EE079f5DDE281B3F1efe70B94",
    "vat": "BE2020112701"
}
```
{% endcode %}

<figure><img src="https://3962621206-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F42KNM6Ikou97oywFeUuW%2Fuploads%2FYhTheIK7G2qLB5k0OmMh%2Fafbeelding.png?alt=media&#x26;token=3741689e-c83e-44af-a545-8daf2cd51ab9" alt=""><figcaption><p>server = <a href="https://url+port/tmining/api/v1">https://url:port/tmining/api/v1</a></p></figcaption></figure>

{% code title="RESPONSE" %}
```json
{
   "release_data":{
      "billOfLading":{
         "blNumber":"RELEASE-API-TEST-1612",
         "portOfLoading":"BEANR",
         "portOfDestination":"BEANR",
         "vessel":"AAA",
         "agent":"BBB",
         "stayNumber":"00001",
         "lloydsNumber":"0002",
         "voyageNumber":"0003",
         "lineCode":"ABC"
      },
      "container":{
         "containerNumber":"CSQU32345690",
         "containerStatus":"released",
         "pickupLocation":"ECTDCD",
         "turnInLocation":"terminal_locode",
         "turnInReference":"aref",
         "termsAndConditions":"base64 encoded data",
         "validFrom":"2017-01-05T14:00:00.000Z",
         "validUntil":"2025-01-05T14:00:00.000Z",
         "isoTypeCode":"45G1",
         "loadStatus":"full",
         "moveType":"import"
      }
   },
   "address":"0x24Fc2D465AaAbf47DA7284920A7B5c3b368EC1D9",
   "deleted":false,
   "blocked":false,
   "encryptedPin":"18570bfece4999db5cd9b6102f9cff472acb5d7e1470bdde8a03cc3db01a6dc1aaf7e132984e7b2b6d7a07aa021f79c833636d8d9bfe4a62a3bef06567b701c579673768ad435d216050edda2f2b99709cc542b65c226f0bfd4f30c8500a4eba300cd538bc565409fe01d01d0d0c23d42bab76c7efe283e89f6e94a5f1b663141aecfe3a97bfeb826996656f622d97e05d4dd7f950f15a9312c507a90ed58f435b13878adf09d2c727fb518ba8d566bbb8c9a9fb2a1a6fefa73a55ec6bc05b14dc6f3cacd201a941f9af018ab1e54f88e0d031e92968a99fa16f9359b8fb943409736f7d2d20ee0011ed1a817e1a12cd760b9473077b6daa533521563dcaf322d6674a4b4417dd09a42a228211289bfedcd07529f983cd26387abfe2b1cd4b6817635d788d6d855104055f7ed6102f0604ac4382204eddfb9e62a9a3c199182319c948d0dabfc62080a93b0c8dac0067431751a4e1e9864fd5d548cd93f9c4edb0b95e0edb500f7846ee05dd13d7578f06c26d11ef107dd0713cc1b42f2e70a75a1a70b5ba107c2eeb6b1aba0723dbf3f8eee674a8ba3ff41da47d9fb91587d9e9c4143f4dadb2c9aa61b444c953720108af392ff3ff85a21542a2100eff453b8c9ffc307200b2fce89a2284716ab14a05b133c22b58359cf9183522fdab46cf033a39c7b262bb7e1015be8c6af837a0a48993a31600db207505f3c9ea1f1c3e",
   "gateOut":null,
   "createdAt":"2021-12-20T14:17:05.623Z",
   "updatedAt":"2022-02-16T08:52:13.251Z",
   "owner":"0x79F98099b2Bf4e5a47244E0cDba500F68b567ce5",
   "creator":"0xa2039dC115B5904c224FEc057684fcCcc88E2f05",
   "greenLights":{
      "total":"green",
      "events":{
         "customs":{
            "color":"green",
            "value":"released",
            "updatedAt":"2023-07-10 13:00"
         },
         "pickuplight":{
            "color":"gray",
            "value":"unknown",
            "updatedAt":""
         },
         "gateoperation":{
            "color":"green",
            "value":"gateoutreceived",
            "updatedAt":"2023-07-12 14:16"
         },
         "terminalready":{
            "color":"green",
            "value":"released",
            "updatedAt":"2023-07-10 12:00"
         },
         "customsprogress":{
            "color":"gray",
            "value":"unknown",
            "updatedAt":""
         },
         "commercialrelease":{
            "color":"green",
            "value":"ok",
            "updatedAt":"2023-07-05 13:37"
         },
         "terminaloperation":{
            "color":"green",
            "value":"discharged",
            "updatedAt":"2023-07-10 11:50"
         }
      },
      "source":"NxtPort"
   },
   "version":"1.2.1",
   "pinRetrieved":false,
   "previousOwner":"0xa2039dC115B5904c224FEc057684fcCcc88E2f05",
   "nextOwner":null,
   "conditions":[
      
   ]
}
```
{% endcode %}

{% hint style="info" %}
Please note that almost all fields in the release details (from the GET /releases-endpoints) can be updated by the carrier.
{% endhint %}

Please find a list below of these fields:

<table><thead><tr><th width="247">Field</th><th width="162">Can be updated?</th><th width="104">By who?</th><th>Is updated in practice?</th></tr></thead><tbody><tr><td><strong>billOfLading</strong></td><td></td><td></td><td></td></tr><tr><td><code>blNumber</code></td><td>yes</td><td>carrier</td><td>no</td></tr><tr><td><code>portOfLoading</code></td><td>yes</td><td>carrier</td><td>no</td></tr><tr><td><code>portOfDestination</code></td><td>yes</td><td>carrier</td><td>no</td></tr><tr><td><code>vessel</code></td><td>yes</td><td>carrier</td><td>no</td></tr><tr><td><code>agent</code></td><td>no</td><td></td><td></td></tr><tr><td><code>stayNumber</code></td><td>yes</td><td>carrier</td><td>no</td></tr><tr><td><code>lloydsNumber</code></td><td>yes</td><td>carrier</td><td>no</td></tr><tr><td><code>voyageNumber</code></td><td>yes</td><td>carrier</td><td>no</td></tr><tr><td><strong>container</strong></td><td></td><td></td><td></td></tr><tr><td><code>containerNumber</code></td><td>yes</td><td>carrier</td><td>no</td></tr><tr><td><code>containerStatus</code></td><td>yes</td><td>SCR app</td><td>Yes, when the carrier blocks or unblocks a release this field is updated.</td></tr><tr><td><code>pickupLocation</code></td><td>yes</td><td>carrier</td><td>Yes, when the pickup location (deep sea terminal) changes.</td></tr><tr><td><code>turnInLocation</code></td><td>yes</td><td>carrier</td><td>Yes, when the turn in location (depot) changes.</td></tr><tr><td><code>turnInReference</code></td><td>yes</td><td>carrier</td><td>Yes, when the turn in location (depot) changes.</td></tr><tr><td><code>termsAndConditions</code></td><td>yes</td><td>carrier</td><td>no</td></tr><tr><td><code>validFrom</code></td><td>yes</td><td>carrier</td><td>no</td></tr><tr><td><code>validUntil</code></td><td>yes</td><td>carrier</td><td>Yes, when the validity period is updated.</td></tr><tr><td><code>isoTypeCode</code></td><td>yes</td><td>carrier</td><td>no</td></tr><tr><td><code>address</code></td><td>no</td><td></td><td></td></tr><tr><td><code>deleted</code></td><td>yes</td><td>carrier</td><td>no</td></tr><tr><td><code>blocked</code></td><td>yes</td><td>carrier</td><td>Yes, this can occur when a container has to be scanned or when the carrier blocks the release temporarily.</td></tr><tr><td><code>encryptedPin</code></td><td>yes</td><td>SCR app</td><td>Yes, when the PIN is updated, for instance when the release is revoked while the pin was already retrieved.</td></tr><tr><td><code>gateOut</code></td><td>yes</td><td>terminal</td><td>Yes, when the container leaves the terminal.</td></tr><tr><td><code>createdAt</code></td><td>no</td><td></td><td></td></tr><tr><td><code>updatedAt</code></td><td>yes</td><td>SCR app</td><td>Yes, when a release is updated.</td></tr><tr><td><code>owner</code></td><td>yes</td><td>SCR app</td><td>Yes, when a release is transferred or revoked.</td></tr><tr><td><code>creator</code></td><td>no</td><td></td><td></td></tr><tr><td><code>version</code></td><td>no</td><td></td><td></td></tr><tr><td><code>pinRetrieved</code></td><td>yes</td><td>SCR app</td><td>Yes, when the pin is retrieved.</td></tr><tr><td><code>previousOwner</code></td><td>yes</td><td>SCR app</td><td>Yes, when a release is transferred or revoked.</td></tr><tr><td><code>nextOwner</code></td><td>yes</td><td>SCR app</td><td>Yes, when a release is transferred or revoked.</td></tr><tr><td><code>conditions</code></td><td>yes</td><td>carrier</td><td>no</td></tr><tr><td><code>greenLights</code></td><td>yes</td><td>Nxtport</td><td>Yes.</td></tr></tbody></table>
