Get parcel - Get an exported parcel info from another domain
If you have a parcel ID that has been exported to the blockchain, you can use this API to obtain information about that parcel. This API can also be used to obtain information about a parcel within your domain. However, the response is different when using this API to retrieve details about a blockchain-exported parcel. Please refer to the Sample Response JSON for more information.
| URL | /parcel/v1/get_parcel/{sParcelid} |
| Method | GET |
| Parameters | parcelid, string |
| Sample Request JSON | |
| Sample Response JSON |
{ "status": "ok", "isvalid": true, "parcel": { "parcelid": "15323846-ae37-4592-b268-d6bcca6f58e1", "isbatch": false, "isindomain": false }, "ledger_fields": { "REQ_GET_LEDGER_FIELDS_FROM_TOKENGLOBAL": [ { "IDLedger_Field_Value": 18258, "IDLedger_Field": 1, "IDTokenGlobal": 68662, "Value_Date": "0000-00-00T00:00:00.000", "Value_String": "Test mixed parcel 1 - Aprl 28/1", "Value_Memo": "", "Value_Int": 0, "Value_Real": 0, "IDMediaGlobal": 0, "Field_Name": "REFERENCE", "Field_Type": 3, "IsActive": true, "IsDeleted": false, "IsUsedForImport": true, "Field_Code": "REFERENCE", "MediaFileName": null, "IDMediaGlobal_Me": null }, { "IDLedger_Field_Value": 18259, "IDLedger_Field": 2, "IDTokenGlobal": 68662, "Value_Date": "0000-00-00T00:00:00.000", "Value_String": "BELGIUM", "Value_Memo": "", "Value_Int": 0, "Value_Real": 0, "IDMediaGlobal": 0, "Field_Name": "KNOWN_ORIGIN", "Field_Type": 3, "IsActive": true, "IsDeleted": false, "IsUsedForImport": true, "Field_Code": "KNOWN_ORIGIN", "MediaFileName": null, "IDMediaGlobal_Me": null }, { "IDLedger_Field_Value": 18261, "IDLedger_Field": 3, "IDTokenGlobal": 68662, "Value_Date": "0000-00-00T00:00:00.000", "Value_String": "", "Value_Memo": "", "Value_Int": 0, "Value_Real": 5, "IDMediaGlobal": 0, "Field_Name": "WEIGHT", "Field_Type": 2, "IsActive": true, "IsDeleted": false, "IsUsedForImport": true, "Field_Code": "WEIGHT", "MediaFileName": null, "IDMediaGlobal_Me": null }, { "IDLedger_Field_Value": 18262, "IDLedger_Field": 4, "IDTokenGlobal": 68662, "Value_Date": "0000-00-00T00:00:00.000", "Value_String": "", "Value_Memo": "", "Value_Int": 5, "Value_Real": 0, "IDMediaGlobal": 0, "Field_Name": "NUMBER_OF_STONES", "Field_Type": 1, "IsActive": true, "IsDeleted": false, "IsUsedForImport": true, "Field_Code": "NUMBER_OF_STONES", "MediaFileName": null, "IDMediaGlobal_Me": null }, { "IDLedger_Field_Value": 18263, "IDLedger_Field": 5, "IDTokenGlobal": 68662, "Value_Date": "0000-00-00T00:00:00.000", "Value_String": "ITALY", "Value_Memo": "", "Value_Int": 0, "Value_Real": 0, "IDMediaGlobal": 0, "Field_Name": "DOMAIN_COUNTRY", "Field_Type": 3, "IsActive": true, "IsDeleted": false, "IsUsedForImport": true, "Field_Code": "DOMAIN_COUNTRY", "MediaFileName": null, "IDMediaGlobal_Me": null }, { "IDLedger_Field_Value": 18264, "IDLedger_Field": 6, "IDTokenGlobal": 68662, "Value_Date": "0000-00-00T00:00:00.000", "Value_String": "ROME", "Value_Memo": "", "Value_Int": 0, "Value_Real": 0, "IDMediaGlobal": 0, "Field_Name": "DOMAIN_CITY", "Field_Type": 3, "IsActive": true, "IsDeleted": false, "IsUsedForImport": true, "Field_Code": "DOMAIN_CITY", "MediaFileName": null, "IDMediaGlobal_Me": null }, { "IDLedger_Field_Value": 18265, "IDLedger_Field": 7, "IDTokenGlobal": 68662, "Value_Date": "0000-00-00T00:00:00.000", "Value_String": "MIXED", "Value_Memo": "", "Value_Int": 0, "Value_Real": 0, "IDMediaGlobal": 0, "Field_Name": "DOMAIN_FACTORY", "Field_Type": 3, "IsActive": true, "IsDeleted": false, "IsUsedForImport": true, "Field_Code": "DOMAIN_FACTORY", "MediaFileName": null, "IDMediaGlobal_Me": null }, { "IDLedger_Field_Value": 18266, "IDLedger_Field": 8, "IDTokenGlobal": 68662, "Value_Date": "0000-00-00T00:00:00.000", "Value_String": "RETAIL", "Value_Memo": "", "Value_Int": 0, "Value_Real": 0, "IDMediaGlobal": 0, "Field_Name": "DOMAIN_DEPARTMENT", "Field_Type": 3, "IsActive": true, "IsDeleted": false, "IsUsedForImport": false, "Field_Code": "DOMAIN_DEPARTMENT", "MediaFileName": null, "IDMediaGlobal_Me": null }, { "IDLedger_Field_Value": 18267, "IDLedger_Field": 9, "IDTokenGlobal": 68662, "Value_Date": "0000-00-00T00:00:00.000", "Value_String": "iTraceiT Demo 2", "Value_Memo": "", "Value_Int": 0, "Value_Real": 0, "IDMediaGlobal": 0, "Field_Name": "DOMAIN_COMPANY", "Field_Type": 3, "IsActive": true, "IsDeleted": false, "IsUsedForImport": false, "Field_Code": "DOMAIN_COMPANY", "MediaFileName": null, "IDMediaGlobal_Me": null }, { "IDLedger_Field_Value": 18268, "IDLedger_Field": 10, "IDTokenGlobal": 68662, "Value_Date": "0000-00-00T00:00:00.000", "Value_String": "MINING", "Value_Memo": "", "Value_Int": 0, "Value_Real": 0, "IDMediaGlobal": 0, "Field_Name": "DOMAIN_SECTOR", "Field_Type": 3, "IsActive": true, "IsDeleted": false, "IsUsedForImport": false, "Field_Code": "DOMAIN_SECTOR", "MediaFileName": null, "IDMediaGlobal_Me": null }, { "IDLedger_Field_Value": 18269, "IDLedger_Field": 14, "IDTokenGlobal": 68662, "Value_Date": "0000-00-00T00:00:00.000", "Value_String": "", "Value_Memo": "{ \"origin\":[ { \"Average_Weight\":1.666666666667, \"Parcel_Weight\":1.666666666667, \"Total_Stones\":1, \"Parcel_Reference\":\"Test mix parcel 3 - Aprl 28\", \"Share_Stones\":0.3333333333333, \"Share_Weight\":0.3333333333333, \"Token_Short\":\"bb0e8903-851d-4363-8fac-5294d98b767b\", \"Parcel_Type\":0, \"Known_Origin\":\"China\", \"Country\":\"China\", \"MineFactory\":\"Burgundy Diamonds\" }, { \"Average_Weight\":1.666666666667, \"Parcel_Weight\":1.666666666667, \"Total_Stones\":1, \"Parcel_Reference\":\"Test mix parcel 2 - Aprl 28\", \"Share_Stones\":0.3333333333333, \"Share_Weight\":0.3333333333333, \"Token_Short\":\"d9a4a2ee-4320-41e1-9a58-f284ae695c22\", \"Parcel_Type\":0, \"Known_Origin\":\"Brazil\", \"Country\":\"Brazil\", \"MineFactory\":\"Mountain Province Diamonds\" }, { \"Average_Weight\":1.666666666667, \"Parcel_Weight\":1.666666666667, \"Total_Stones\":1, \"Parcel_Reference\":\"Test mix parcel 1 - Aprl 28\", \"Share_Stones\":0.3333333333333, \"Share_Weight\":0.3333333333333, \"Token_Short\":\"cd6f7648-2053-40d6-8af9-af12ea95b95d\", \"Parcel_Type\":0, \"Known_Origin\":\"DTC\", \"Country\":\"DTC\", \"MineFactory\":\"Rio Tinto\" } ] }", "Value_Int": 0, "Value_Real": 0, "IDMediaGlobal": 0, "Field_Name": "ORIGINS", "Field_Type": 5, "IsActive": true, "IsDeleted": false, "IsUsedForImport": true, "Field_Code": "ORIGINS", "MediaFileName": null, "IDMediaGlobal_Me": null }, { "IDLedger_Field_Value": 18260, "IDLedger_Field": 25, "IDTokenGlobal": 68662, "Value_Date": "0000-00-00T00:00:00.000", "Value_String": "BELGIUM", "Value_Memo": "", "Value_Int": 0, "Value_Real": 0, "IDMediaGlobal": 0, "Field_Name": "PARCEL_COUNTRY", "Field_Type": 3, "IsActive": true, "IsDeleted": false, "IsUsedForImport": true, "Field_Code": "PARCEL_COUNTRY", "MediaFileName": null, "IDMediaGlobal_Me": null } ] }, "already_imported": 1, "already_imported_in_token": "e19b3d6f-89f3-43bd-a4b0-5bf814de7178" } |
| Response Codes | 200: ok |
| Note |
already_imported = 0 (Not already imported) already_imported = 1 (Already imported) already_imported_in_token = "token_id" (If already_imported = 1) |