Adjust weight on hand

Record a change to the sample's weight on hand.

The first adjustment is taken as the sample's initial weight on hand; every
later adjustment appends to a log of alterations over time. An
amount_changed of 0 records nothing and simply returns the current weight.

unit must be g or units, and change_reason must be an integer from the
enum below.

Change reasons

Unless the lab reports to a regulator, change_reason uses this default enum:

  • 0 other
  • 1 initial
  • 2 destroyed
  • 3 used
  • 4 returned
  • 5 lost
  • 6 stolen
  • 7 addition

Labs in a METRC state should use a reason from their own state's list instead.
Reasons outside a state's list are accepted without error, but the weight change
may reach METRC incorrectly. 0 is an allowable value everywhere; in most
states it is not forwarded to METRC at all.

  • METRC CA
    • 0 other (Allowable value, not sent to METRC)
    • 2 Scale Variance
    • 3 Sample Tested
    • 106 Sample Tested
    • 101 Waste (Unusable Product)
    • 108 Damage
    • 215 Enforcement Testing
    • 107 Incorrect Quantity
    • 214 Male Plants
    • 213 Mandated Destruction
    • 212 Onsite Testing
    • 211 Over Pulled
    • 210 Research & Development
    • 105 Scale Variance
    • 209 Spoilage
    • 104 State-Authorized Adjustment
    • 103 Theft
    • 208 Trade Sample
    • 207 Under Pulled
    • 102 Voluntary Surrender
    • 206 Weight Change Due to Moisture
  • METRC IL
    • 0 other (Allowable value, not sent to METRC)
    • 288 Consumed During Testing
    • 287 Entry Error
    • 290 Inventory Audit
    • 286 Package Material
    • 285 Scale Variance
    • 284 Spoilage
    • 283 Theft
    • 282 Waste
  • METRC LA
    • 0 other (Allowable value, not sent to METRC)
    • 111 Test Sample Waste (Lab only)
    • 116 Potency Testing
    • 122 Contaminant Testing
    • 121 Drying
    • 120 During Transfer
    • 119 Entry Error
    • 118 Package Material
    • 117 Plants Unpacked
    • 115 R&D Testing
    • 114 Scale Variance
    • 113 Spoilage
    • 112 State-Ordered Destruction/State Mandated Destruction
    • 110 Theft
    • 109 Waste
  • METRC MA
    • 0 other (Allowable value, not sent to METRC)
    • 2 Test Sample Destruction
    • 3 Sample Used During Testing
    • 5 Waste
    • 128 Sample Used During Testing
    • 125 Test Sample Destruction
    • 135 API Related Error
    • 134 Drying
    • 133 Entry Error
    • 132 Over/Under Pulled
    • 131 Package Material
    • 130 Plants Unpacked
    • 129 Processing Loss
    • 127 Scale Variance
    • 126 Spoilage
    • 124 Theft
    • 123 Waste
  • METRC MD
    • 0 other (Allowable value, not sent to METRC)
    • 2 Drying
    • 3 Waste
    • 5 Spoilage
    • 136 Waste
    • 139 Scale Variance
    • 144 API Adjustment Error
    • 143 Drying
    • 142 Entry Error
    • 141 MCA Inspector Obtained Product
    • 140 Plants Unpacked
    • 138 Spoilage
    • 137 Theft
    • 263 Unaccounted Product
  • METRC ME
    • 0 other (Allowable value, not sent to METRC)
    • 151 Sample Used During Testing
    • 147 Test Sample Destruction
    • 156 API Related Error
    • 155 Drying
    • 154 Entry Error
    • 153 Over/Under Pulled
    • 152 R&D Sample
    • 150 Scale Variance
    • 149 Spoilage
    • 148 State Mandated Destruction
    • 146 Theft
    • 145 Waste
  • METRC MI
    • 0 other (Allowable value, not sent to METRC)
    • 3 Waste
    • 6 Scale Variance
    • 157 Waste
    • 159 Spoilage
    • 162 Drying
    • 161 Entry Error
    • 160 Scale Variance
    • 158 Theft
  • METRC MN
    • 0 other (Allowable value, not sent to METRC)
    • 170 Consumed During Testing
    • 164 Test Sample Destruction
    • 169 Drying
    • 168 Entry Error
    • 295 Hazardous Waste
    • 294 Non-Hazardous Waste
    • 167 Package Material
    • 307 Quantity Discrepancy
    • 165 Spoilage
    • 306 State Investigation
    • 163 Theft
    • 293 Waste
  • METRC MO
    • 0 other (Allowable value, not sent to METRC)
    • 182 Consumed During Testing
    • 171 Waste
    • 183 API Error
    • 181 Damaged
    • 180 Drying
    • 179 Mandatory State Destruction
    • 178 Moisture Weight Change
    • 177 Over/Under Pulled
    • 176 Package Material
    • 175 Recall
    • 174 Spoilage
    • 173 Theft
    • 172 Typing Error
  • METRC MS
    • 0 other (Allowable value, not sent to METRC)
    • 281 Drying
    • 280 During Transfer
    • 279 Entry Error
    • 278 Package Material
    • 277 Scale Variance
    • 276 Spoilage
    • 275 Theft
    • 274 Waste
  • METRC MT
    • 0 other (Allowable value, not sent to METRC)
    • 247 Contaminant Testing
    • 240 Waste
    • 246 Drying
    • 245 Entry Error
    • 244 Scale Variance
    • 243 Spoilage
    • 242 State Mandated Destruction
    • 241 Theft
  • METRC NJ
    • 0 other (Allowable value, not sent to METRC)
    • 190 Consumed During Testing
    • 184 Waste
    • 189 Drying
    • 308 Enforcement Investigation
    • 188 Entry Error
    • 187 Scale Variance
    • 186 Spoilage
    • 185 Theft
  • METRC NV
    • 0 other (Allowable value, not sent to METRC)
    • 2 Package Destruction/Waste
    • 3 Test Sample Consumed in Testing
    • 4 Entry Error
    • 5 Nevada Dept.of Agriculture
    • 6 Scale Variance
    • 251 Test Sample Consumed in Testing
    • 255 Package Destruction/Waste
    • 292 API Adjustment Error
    • 259 Drying
    • 258 Entry Error
    • 257 Nevada Dept.of Agriculture
    • 256 Over Pulled
    • 254 Plants Unpacked
    • 253 Scale Variance
    • 252 Spoilage
    • 250 Theft
    • 249 Transfer Error
    • 291 Unaccounted Product Variance
    • 248 Under Pulled
  • METRC NY
    • 0 other (Allowable value, not sent to METRC)
    • 305 Consumed During Testing
    • 298 Waste
    • 304 Damage During Transfer
    • 303 Drying
    • 302 Entry Error
    • 301 Scale Variance
    • 300 Spoilage
    • 299 Theft
  • METRC OH
    • 0 other (Allowable value, not sent to METRC)
    • 2 Laboratory Testing
    • 3 Destruction - Waste/Other
    • 5 Laboratory Testing
    • 6 Plant Material - Moisture Gain/Loss
    • 194 Laboratory Testing
    • 195 Destruction - Waste/Other
    • 199 Data Entry Error
    • 198 Destruction - Expired
    • 197 Destruction - Failed Testing
    • 196 Destruction - Recall
    • 297 Inventory Reconciliation
    • 296 Loss, Theft, or Diversion
    • 192 Plant Material - Moisture Gain/Loss
    • 191 Scale Variance
  • METRC OK
    • 0 other (Allowable value, not sent to METRC)
    • 220 Sample Used During Testing
    • 224 Contaminant Testing
    • 225 API Related Error
    • 223 Damage/Spoilage
    • 222 Drying
    • 221 Mandatory State Destruction
    • 219 Scale Variance
    • 218 Test Sample Destruction
    • 217 Theft
    • 216 Typing/Entry Error
  • METRC OR
    • 0 Moisture Loss/Gain
    • 2 Sample Destroyed (Lab Use Only)
    • 3 Waste
    • 231 Sample Destroyed (Lab Use Only)
    • 226 Waste
    • 239 API Adjustment Error
    • 238 API Conversion Error
    • 237 During License-to-License Transfer
    • 236 Entry Error
    • 235 In-House Quality Control
    • 234 Moisture Loss/Gain
    • 233 Package Material
    • 232 Plant Death
    • 230 Scale Variance
    • 229 Spoilage
    • 228 Theft
    • 227 Trade Sample
  • METRC RI
    • 0 other (Allowable value, not sent to METRC)
    • 205 Consumed during Testing
    • 200 Waste
    • 204 Entry Error
    • 317 QA Sample to RIDOH
    • 203 Scale Variance
    • 202 Spoilage
    • 201 Theft
  • METRC SD
    • 0 other (Allowable value, not sent to METRC)
    • 260 Waste
    • 262 Drying
    • 261 Entry Error
  • METRC Tribal Nations
    • 0 other (Allowable value, not sent to METRC)
    • 312 Test Sample Consumed in Testing
    • 309 Waste
    • 316 Entry Error
    • 315 Plants Unpacked
    • 314 Scale Variance
    • 313 Spoilage
    • 311 Theft
    • 310 Transfer Error
  • METRC 29 Palms
    • 0 other (Allowable value, not sent to METRC)
    • 265 Waste (Unusable Product)
    • 273 Damage
    • 272 Enforcement Testing
    • 271 Incorrect Quantity
    • 270 Mandated Destruction
    • 269 Over Pulled
    • 268 TCC-Authorized Adjustment
    • 267 Theft
    • 266 Under Pulled
    • 264 Weight Change Due to Moisture
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
Form Data
string
required

Unit for amount_changed: g or units.

number
required

Signed amount to add to the weight on hand; negative values reduce it. 0 records nothing and returns the current weight.

integer
required

Integer reason ID for the change; see the description above.

Headers
string

HMAC-SHA256 request signature. Required only when request signing is enabled for your API key — see the Request Signing guide.

string

Unix timestamp (seconds) of the request, required only when request signing is enabled for your API key. Requests older than 30 seconds are rejected.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json