--- title: Get parcel list with filter description: This API allows you to find a list of parcels by using search filters. Please refer to the last row of the table for instructions on how to use search filters. dcreatedfrom, date dcreatedto, date nlim --- [Skip to content](https://support.itraceit.io/en/get-parcel-list-with-filter#main-content) English Show submenu for translations [![itraceit](https://support.itraceit.io/hs-fs/hubfs/itraceit-slogan.png?height=50&name=itraceit-slogan.png)](https://itraceit.io/?hsLang=en) Open main navigation Close main navigation - English Show submenu for translations - [Log to my account](https://europe-workflow.itraceit.io/) [Log to my account](https://europe-workflow.itraceit.io/) How can we help you? - There are no suggestions because the search field is empty. 1. [iTraceiT](https://support.itraceit.io/en?hsLang=en) 2. [Developer Documentation](https://support.itraceit.io/en/developer-documentation?hsLang=en) # Get parcel list with filter This API allows you to find a list of parcels by using search filters. Please refer to the last row of the table for instructions on how to use search filters. | URL | [/parcel/v2/get\_parcel\_list](https://docs.itraceit.io/en/API/Parcel) | | --- | --- | | Method | POST  | | Parameters | dcreatedfrom, date dcreatedto, date nlimitfrom, integer nlimitto, integer ssort, string sreference, string sowneruser, string ntotalstonesfrom, intege ntotalstonesto, intege  rweightfrom: float rweightto, float scountry, string sparcelcountry, string scity, string sminefactory, string nisexported, integer nislinkedtoparent, integer sparcelsearch, string nparceltype, integer nmetadatadefinitionid, string smetadatavalue, string | | Sample Request JSON | { "dcreatedfrom":20230405, "dcreatedto":20230406, "nlimitfrom":0, "nlimitto":65, "ssort":"numberofstones ASC ,datecreated ASC", "reference":"", "sowneruser":"", "ntotalstonesfrom": null, "ntotalstonesto": null, "rweightfrom": 45.52, "rweightto": 45.52, "country":"", "sparcelcountry": "", "scity":"", "sminefactory":"", "nisexported":0, "nislinkedtoparent": 0, "sparcelsearch": "", "nparceltype": 0, "nmetadatadefinitionid": "", "smetadatavalue": "" }  | | Sample Response JSON | {    "status": "ok",    "isvalid": true,    "domid": "d7e19951-6990-402e-a1f3-357bd375ee61",    "parcel": \[         {           "parcelid": "11393241-59ef-4c79-8b44-1d2f38b4a8d3",           "parcelreference": "",           "parcelweight": 0,           "numberofstones": 0,           "averageweight": 0,           "parceltype": 2,           "parcelbatchid": "895b706b-c578-4e61-82eb-a54650b726cb",           "owneruserid": "ef086e7c-48f4-4116-b12b-84c2cf16a004",           "owneruser": "Shashika ",           "datecreated": "2023-04-06T10:10:14.816",           "datemodified": "2023-04-06T10:10:14.816",           "parcelcountry": "BELGIUM",           "domaincountry": "BELGIUM",           "minefactory": "Alrosa",           "city": "BRAINE-LE-COMTE",          "isexported": false,          "islinkedtoparent": false,          "metadatavaluememo": "",          "metadatavaluestring": ""       }     \], "number\_parcels\_sent": 1, "number\_parcels": 1 } | | Response Codes |  200: ok | | **Note** | - dcreatedfrom (format YYYYMMDD). Leave it **NULL** if you are not going to filter by this parameter. - dcreatedto (format YYYYMMDD). Leave it **NULL** if you are not going to filter by this parameter. - to only show for one date, set dcreatedfrom = dcreatedto - nlimitfrom -\> shows only results from nlimitfrom (default : 0) - nlimitto -\> shows only results to nlimitto (default : end of records) - ssort -\> specify the sorting (default : IDParcel desc) - Sorting can be a mix of the **following**, separated by a comma ',' with parameter ASC or DESC (Eg: weight DESC, numberofstones DESC, idparcel  DESC) - idparcel,  parcelid, weight, numberofstones, reference, datecreated, datemodified - sreference -\> force display for a specific reference or part of a reference (it's doing a LIKE %{sreference}%). Leave it empty if you are not going to filter by this parameter. - sowneruser -\> force display for a user or part of it (do a LIKE%..% into UserLastName UserFirstName and UserEmail). Leave it empty if you are not going to filter by this parameter. - scountry -\> force display for a country or part of it. Leave it empty if you are not going to filter by this parameter. - sparcelcountry -\> same for a parcel country or part of it. Leave it empty if you are not going to filter by this parameter. - scity -\> force display for a city or part of it. Leave it empty if you are not going to filter by this parameter. - sminefactory -\> force display for a mining factory or part of it. Leave it empty if you are not going to filter by this parameter. - nisexported -\> is exported or not (0 for all (default), 1 for exported, 2 for non exported) - nislinkedtoparent -\> has parent or not (0 for all, 1 for has parent, 2 has no parent) - sparcelsearch : a text that will look into (OR) - Can search by parcelweight **OR** numberofstones **OR** reference **OR** mining company **OR** parcel\_country **OR **city - nparceltype : 0 for all, 2 for parcel, 3 for merged - nmetadatadefinitionid : look into the extra field name,  Leave it empty if you are not going to filter by this parameter. - smetadatavalue : for this extra field value,  Leave it empty if you are not going to filter by this parameter.   - Response - number\_parcels\_sent → limit your set to nlimitto parameter - number\_parcels → Total number of parcels |   - [Getting Started](https://support.itraceit.io/en/getting-started?hsLang=en#main-content) - [1. Introduction to iTraceiT](https://support.itraceit.io/en/getting-started?hsLang=en#1-introduction-to-itraceit) - [2. Starting Point & Responsibility](https://support.itraceit.io/en/getting-started?hsLang=en#2-starting-point-responsibility) - [3. Account Setup & Configuration](https://support.itraceit.io/en/getting-started?hsLang=en#3-account-setup-configuration) - [4. Interface & Navigation](https://support.itraceit.io/en/getting-started?hsLang=en#4-interface-navigation) - [Using iTraceiT](https://support.itraceit.io/en/using-itraceit?hsLang=en#main-content) - [Step 1 : Create & Import QR Codes](https://support.itraceit.io/en/using-itraceit?hsLang=en#step-1-create-import-qr-codes) - [Step 2: Add & Enrich Information](https://support.itraceit.io/en/using-itraceit?hsLang=en#step-2-add-enrich-information) - [Step 3: Split, Merge & Group QR Codes](https://support.itraceit.io/en/using-itraceit?hsLang=en#step-3-split-merge-group-qr-codes) - [Step 4: Publish & Share QR Codes](https://support.itraceit.io/en/using-itraceit?hsLang=en#step-4-publish-share-qr-codes) - [Manage QR Code Lifecycle](https://support.itraceit.io/en/using-itraceit?hsLang=en#manage-qr-code-lifecycle) - [Developer Documentation](https://support.itraceit.io/en/developer-documentation?hsLang=en) - [Sectors & Actors](https://support.itraceit.io/en/sectors-actors?hsLang=en#main-content) - [SCS Global Services](https://support.itraceit.io/en/sectors-actors?hsLang=en#scs-global-services) - [Blockchain & Security](https://support.itraceit.io/en/blockchain-security?hsLang=en) - [Data Privacy & Compliance](https://support.itraceit.io/en/data-privacy-compliance?hsLang=en) - [Troubleshooting & FAQ](https://support.itraceit.io/en/troubleshooting-faq?hsLang=en) - [Glossary](https://support.itraceit.io/en/glossary?hsLang=en) [![logo-white](https://support.itraceit.io/hs-fs/hubfs/logo-white.png?width=120&height=37&name=logo-white.png "logo-white")](https://itplace.com/en/) Copyright © 2025, IT Place (TITP Srl)