> For the complete documentation index, see [llms.txt](https://docs.shortcutco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shortcutco.com/developers/api-reference/reference/chemical-records.md).

# Chemical records

Chemical application records and the product library.

A chemical application is the record a crew completes after applying fertilizer, weed control, or pest control: products and amounts, EPA numbers, applicator and license, weather, and re-entry. Records can be read by customer, or across customers by date with the ones still open, each with its amendment history. The product library holds each product's EPA number, re-entry rule, fertilizer analysis, after-care text and label link; a label's signal word, restrictions and first aid are not stored.

Fields: [The chemical application object](https://docs.shortcutco.com/developers/reference/objects/chemical-application).

## List chemical application records

> Chemical application records across customers whose visit falls between \`from\` and \`to\` (default the last 30 days; at most 400 days), newest made first. \`status=completed\` for the legal records, \`open\` for the ones not recorded yet, \`all\` (default) for both. A completed record carries the products and amounts, EPA numbers, re-entry captured at completion (\`Not set\` when no rule was stored), weather at the start and the finish, the applicator and license, the treated area, the posting sign and the crew's notes; an open one carries its planned products. Narrow to one customer or property with \`customerId\` or \`propertyId\`.\
> \
> Returns a list of \[chemical application record objects]\(<https://docs.shortcutco.com/developers/reference/objects/chemical-application-record>).

```json
{"openapi":"3.1.0","info":{"title":"Shortcut API","version":"v1"},"tags":[{"name":"Chemical records","description":"A chemical application is the record a crew completes after applying fertilizer, weed control, or pest control: products and amounts, EPA numbers, applicator and license, weather, and re-entry. Records can be read by customer, or across customers by date with the ones still open, each with its amendment history. The product library holds each product's EPA number, re-entry rule, fertilizer analysis, after-care text and label link; a label's signal word, restrictions and first aid are not stored.\n\nFields: [The chemical application object](https://docs.shortcutco.com/developers/reference/objects/chemical-application)."}],"servers":[{"url":"https://api.shortcutco.com","description":"Production"}],"security":[{"bearerAuth":["customers:read","chemicals:read"]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"scut_<env>_<id>_<secret>","description":"A workspace API token. Each operation lists the scopes it needs; `write` implies `read`, and `send`/`complete` are never implied."}},"headers":{"RateLimitLimit":{"schema":{"type":"integer"},"description":"Requests allowed in the tightest window."},"RateLimitRemaining":{"schema":{"type":"integer"},"description":"Requests left in that window."},"RateLimitReset":{"schema":{"type":"integer"},"description":"Seconds until that window resets."}},"schemas":{"ChemicalApplicationRecord":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The application record's id."},"object":{"type":"string","const":"chemical_application_record","description":"Always `chemical_application_record`."},"status":{"type":"string","enum":["completed","open"],"description":"`completed`: the legal record. `open`: not recorded yet (the crew has not finished it, or the office has not recorded it)."},"customerId":{"type":"string","format":"uuid","description":"The customer it was applied for."},"customerName":{"type":"string","description":"The customer's name."},"visitId":{"type":"string","format":"uuid","description":"The visit it was applied on."},"date":{"type":"string","description":"The day it was applied (on an open record, the visit's day), `YYYY-MM-DD`."},"serviceName":{"type":["string","null"],"description":"The catalog service or add-on it was part of."},"jobName":{"type":"string","description":"The job's name."},"propertyAddress":{"type":["string","null"],"description":"The property it was applied at."},"completedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When the record was completed, ISO 8601 in UTC; null on an open record."},"completedBy":{"anyOf":[{"type":"string","enum":["crew","office"]},{"type":"null"}],"description":"`crew` when the crew completed it in the field, `office` when the office recorded it as planned."},"applicatorName":{"type":["string","null"],"description":"Who applied it."},"applicatorLicense":{"type":["string","null"],"description":"The applicator licence number on the record."},"applicatorLicenseIsToday":{"type":"boolean","description":"True when the record holds no licence of its own and `applicatorLicense` is the person's licence today, not the one stamped at completion."},"treatedSqft":{"type":["number","null"],"description":"The area treated, in square feet."},"lines":{"type":"array","items":{"$ref":"#/components/schemas/ChemicalApplicationRecordLine"},"description":"The products, in the record's order."},"weather":{"anyOf":[{"$ref":"#/components/schemas/ChemicalWeather"},{"type":"null"}],"description":"Weather at the start of the application (the crew's own reading when they entered one)."},"weatherAtFinish":{"anyOf":[{"type":"object","properties":{"temperatureF":{"type":["number","null"]},"windSpeedMph":{"type":["number","null"]},"windDirectionDeg":{"type":["number","null"]},"humidityPct":{"type":["number","null"]},"precipitationIn":{"type":["number","null"]}},"required":["temperatureF","windSpeedMph","windDirectionDeg","humidityPct","precipitationIn"],"additionalProperties":false,"description":"The weather service's reading for the hour the application was finished."},{"type":"null"}],"description":"The weather service's reading at the finish; null when not captured."},"reentry":{"type":["string","null"],"description":"The office's re-entry line for the whole record, naming any product whose rule is not set."},"customerReentry":{"type":["string","null"],"description":"The line a customer may be told; null unless every product has a rule."},"postingSignPlaced":{"type":["boolean","null"],"description":"Whether the crew placed a posting sign; null when not asked."},"notes":{"type":["string","null"],"description":"The crew's notes on the application."},"revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The record's revision: 1 when never amended; null on an open record."},"amendmentReason":{"type":["string","null"],"description":"Why the latest amendment was made."}},"required":["id","object","status","customerId","customerName","visitId","date","serviceName","jobName","propertyAddress","completedAt","completedBy","applicatorName","applicatorLicense","applicatorLicenseIsToday","treatedSqft","lines","weather","weatherAtFinish","reentry","customerReentry","postingSignPlaced","notes","revision","amendmentReason"],"additionalProperties":false,"description":"A chemical application record, completed or open."},"ChemicalApplicationRecordLine":{"type":"object","properties":{"productId":{"type":"string","format":"uuid","description":"The product's id (get_chemical_product reads its label link)."},"position":{"type":"integer","description":"The line's place on the record; the amend card names a line by product and position."},"productName":{"type":"string","description":"The product, as the record captured it."},"productType":{"anyOf":[{"type":"string","enum":["fertilizer","pesticide","other"]},{"type":"null"}],"description":"What kind of product it is."},"epaRegNo":{"type":["string","null"],"description":"The EPA registration number captured on the record."},"epaApplicable":{"type":"boolean","description":"Whether state filing rules treat the product as EPA-registered."},"amount":{"type":["string","null"],"description":"How much: the recorded amount, else the planned one, e.g. `2 fl oz`."},"amountIsPlanned":{"type":"boolean","description":"True when `amount` is the planned amount because none was recorded (always on an open record)."},"plannedAmount":{"type":["string","null"],"description":"The planned amount."},"reentry":{"type":"string","description":"The re-entry rule: `24 hours`, `Until sprays dry`, `None`, or `Not set` when no rule is stored, which never means safe. On a completed record it is the rule captured at completion; on an open record it is the product's rule today."},"targetPests":{"type":["string","null"],"description":"What the product targets."},"varianceReason":{"type":["string","null"],"description":"Why the amount differed from the plan, when it did."},"isSubstitution":{"type":"boolean","description":"Whether the product replaced the planned one."}},"required":["productId","position","productName","productType","epaRegNo","epaApplicable","amount","amountIsPlanned","plannedAmount","reentry","targetPests","varianceReason","isSubstitution"],"additionalProperties":false,"description":"One product on a chemical application record."},"ChemicalWeather":{"type":"object","properties":{"temperatureF":{"type":["number","null"],"description":"Temperature, °F."},"windSpeedMph":{"type":["number","null"],"description":"Wind speed, mph."},"windDirectionDeg":{"type":["number","null"],"description":"Wind direction, degrees from north."},"humidityPct":{"type":["number","null"],"description":"Relative humidity, %."},"precipitationIn":{"type":["number","null"],"description":"Precipitation, inches."},"manual":{"type":"boolean","description":"Whether the crew entered it rather than a weather service."},"soilTemperatures":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","enum":["entered","forecast"],"description":"Where it came from: a reading a person entered, or the forecast."},"temperatureF":{"type":"number","description":"Soil temperature, °F, to one decimal."},"enteredBy":{"type":["string","null"],"description":"Who entered the reading; null for the forecast or when not known."}},"required":["source","temperatureF","enteredBy"],"additionalProperties":false},"description":"Soil temperature by source, never merged. Absent when none was recorded."}},"required":["temperatureF","windSpeedMph","windDirectionDeg","humidityPct","precipitationIn","manual"],"additionalProperties":false,"description":"Weather at the time of the application."},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Error family, such as `invalid_request` or `permission`."},"code":{"type":"string","description":"Specific error code; see the errors page."},"message":{"type":"string","description":"A human-readable explanation."},"param":{"type":"string","description":"The input the error is about, such as `query.limit`."},"requiredScope":{"type":"string","description":"The scope the token is missing."},"requestId":{"type":"string","description":"Quote this id to support."},"docs":{"type":"string","description":"Link to the error's documentation."}},"required":["type","code","message","requestId","docs"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}},"responses":{"BadRequest":{"description":"The request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthenticated":{"description":"The token is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"SubscriptionRequired":{"description":"The workspace's subscription needs attention.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"The token is missing a required scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"No such object in this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Rate limited; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"Temporarily unavailable; retry later.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/v1/chemical-applications":{"get":{"operationId":"chemicals.applications.list","tags":["Chemical records"],"summary":"List chemical application records","description":"Chemical application records across customers whose visit falls between `from` and `to` (default the last 30 days; at most 400 days), newest made first. `status=completed` for the legal records, `open` for the ones not recorded yet, `all` (default) for both. A completed record carries the products and amounts, EPA numbers, re-entry captured at completion (`Not set` when no rule was stored), weather at the start and the finish, the applicator and license, the treated area, the posting sign and the crew's notes; an open one carries its planned products. Narrow to one customer or property with `customerId` or `propertyId`.\n\nReturns a list of [chemical application record objects](https://docs.shortcutco.com/developers/reference/objects/chemical-application-record).","parameters":[{"name":"from","in":"query","required":false,"description":"The first visit day (default 30 days before `to`), `YYYY-MM-DD` in the workspace's timezone.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":false,"description":"The last visit day (default today), `YYYY-MM-DD` in the workspace's timezone.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"status","in":"query","required":false,"description":"Which records: completed, open (not recorded yet), or all.","schema":{"type":"string","enum":["completed","open","all"],"default":"all"}},{"name":"customerId","in":"query","required":false,"description":"Only this customer's records.","schema":{"type":"string","format":"uuid"}},{"name":"propertyId","in":"query","required":false,"description":"Only this property's records.","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"description":"How many items to return, 1-200. Defaults to 50.","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","required":false,"description":"The `meta.nextCursor` from the previous page. Omit it for the first page.","schema":{"type":"string","minLength":1,"maxLength":4096}}],"responses":{"200":{"description":"Success.","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ChemicalApplicationRecord"}},"meta":{"type":"object","properties":{"nextCursor":{"type":["string","null"],"description":"Pass as `cursor` to get the next page; null on the last page."},"hasMore":{"type":"boolean","description":"Whether another page exists."}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"402":{"$ref":"#/components/responses/SubscriptionRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}}}}
```

## Get a chemical application record and its history

> One chemical application record in full (products and amounts, EPA numbers, re-entry captured at completion, weather at the start and the finish, applicator and license, treated area, posting sign, notes, who completed it) and its history: every completion and amendment, newest first, with who made it, when, the reason, and the amounts, area and notes it held. An open record has no history yet.\
> \
> Returns \[the chemical application record object]\(<https://docs.shortcutco.com/developers/reference/objects/chemical-application-record>).

```json
{"openapi":"3.1.0","info":{"title":"Shortcut API","version":"v1"},"tags":[{"name":"Chemical records","description":"A chemical application is the record a crew completes after applying fertilizer, weed control, or pest control: products and amounts, EPA numbers, applicator and license, weather, and re-entry. Records can be read by customer, or across customers by date with the ones still open, each with its amendment history. The product library holds each product's EPA number, re-entry rule, fertilizer analysis, after-care text and label link; a label's signal word, restrictions and first aid are not stored.\n\nFields: [The chemical application object](https://docs.shortcutco.com/developers/reference/objects/chemical-application)."}],"servers":[{"url":"https://api.shortcutco.com","description":"Production"}],"security":[{"bearerAuth":["customers:read","chemicals:read"]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"scut_<env>_<id>_<secret>","description":"A workspace API token. Each operation lists the scopes it needs; `write` implies `read`, and `send`/`complete` are never implied."}},"headers":{"RateLimitLimit":{"schema":{"type":"integer"},"description":"Requests allowed in the tightest window."},"RateLimitRemaining":{"schema":{"type":"integer"},"description":"Requests left in that window."},"RateLimitReset":{"schema":{"type":"integer"},"description":"Seconds until that window resets."}},"schemas":{"ChemicalApplicationRecordWithHistory":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The application record's id."},"object":{"type":"string","const":"chemical_application_record","description":"Always `chemical_application_record`."},"status":{"type":"string","enum":["completed","open"],"description":"`completed`: the legal record. `open`: not recorded yet (the crew has not finished it, or the office has not recorded it)."},"customerId":{"type":"string","format":"uuid","description":"The customer it was applied for."},"customerName":{"type":"string","description":"The customer's name."},"visitId":{"type":"string","format":"uuid","description":"The visit it was applied on."},"date":{"type":"string","description":"The day it was applied (on an open record, the visit's day), `YYYY-MM-DD`."},"serviceName":{"type":["string","null"],"description":"The catalog service or add-on it was part of."},"jobName":{"type":"string","description":"The job's name."},"propertyAddress":{"type":["string","null"],"description":"The property it was applied at."},"completedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"description":"When the record was completed, ISO 8601 in UTC; null on an open record."},"completedBy":{"anyOf":[{"type":"string","enum":["crew","office"]},{"type":"null"}],"description":"`crew` when the crew completed it in the field, `office` when the office recorded it as planned."},"applicatorName":{"type":["string","null"],"description":"Who applied it."},"applicatorLicense":{"type":["string","null"],"description":"The applicator licence number on the record."},"applicatorLicenseIsToday":{"type":"boolean","description":"True when the record holds no licence of its own and `applicatorLicense` is the person's licence today, not the one stamped at completion."},"treatedSqft":{"type":["number","null"],"description":"The area treated, in square feet."},"lines":{"type":"array","items":{"$ref":"#/components/schemas/ChemicalApplicationRecordLine"},"description":"The products, in the record's order."},"weather":{"anyOf":[{"$ref":"#/components/schemas/ChemicalWeather"},{"type":"null"}],"description":"Weather at the start of the application (the crew's own reading when they entered one)."},"weatherAtFinish":{"anyOf":[{"type":"object","properties":{"temperatureF":{"type":["number","null"]},"windSpeedMph":{"type":["number","null"]},"windDirectionDeg":{"type":["number","null"]},"humidityPct":{"type":["number","null"]},"precipitationIn":{"type":["number","null"]}},"required":["temperatureF","windSpeedMph","windDirectionDeg","humidityPct","precipitationIn"],"additionalProperties":false,"description":"The weather service's reading for the hour the application was finished."},{"type":"null"}],"description":"The weather service's reading at the finish; null when not captured."},"reentry":{"type":["string","null"],"description":"The office's re-entry line for the whole record, naming any product whose rule is not set."},"customerReentry":{"type":["string","null"],"description":"The line a customer may be told; null unless every product has a rule."},"postingSignPlaced":{"type":["boolean","null"],"description":"Whether the crew placed a posting sign; null when not asked."},"notes":{"type":["string","null"],"description":"The crew's notes on the application."},"revision":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"The record's revision: 1 when never amended; null on an open record."},"amendmentReason":{"type":["string","null"],"description":"Why the latest amendment was made."},"history":{"type":"array","items":{"$ref":"#/components/schemas/ChemicalApplicationRevision"},"description":"Every completion and amendment, newest first. Empty on an open record; draft saves are not records."}},"required":["id","object","status","customerId","customerName","visitId","date","serviceName","jobName","propertyAddress","completedAt","completedBy","applicatorName","applicatorLicense","applicatorLicenseIsToday","treatedSqft","lines","weather","weatherAtFinish","reentry","customerReentry","postingSignPlaced","notes","revision","amendmentReason","history"],"additionalProperties":false,"description":"A chemical application record, completed or open."},"ChemicalApplicationRecordLine":{"type":"object","properties":{"productId":{"type":"string","format":"uuid","description":"The product's id (get_chemical_product reads its label link)."},"position":{"type":"integer","description":"The line's place on the record; the amend card names a line by product and position."},"productName":{"type":"string","description":"The product, as the record captured it."},"productType":{"anyOf":[{"type":"string","enum":["fertilizer","pesticide","other"]},{"type":"null"}],"description":"What kind of product it is."},"epaRegNo":{"type":["string","null"],"description":"The EPA registration number captured on the record."},"epaApplicable":{"type":"boolean","description":"Whether state filing rules treat the product as EPA-registered."},"amount":{"type":["string","null"],"description":"How much: the recorded amount, else the planned one, e.g. `2 fl oz`."},"amountIsPlanned":{"type":"boolean","description":"True when `amount` is the planned amount because none was recorded (always on an open record)."},"plannedAmount":{"type":["string","null"],"description":"The planned amount."},"reentry":{"type":"string","description":"The re-entry rule: `24 hours`, `Until sprays dry`, `None`, or `Not set` when no rule is stored, which never means safe. On a completed record it is the rule captured at completion; on an open record it is the product's rule today."},"targetPests":{"type":["string","null"],"description":"What the product targets."},"varianceReason":{"type":["string","null"],"description":"Why the amount differed from the plan, when it did."},"isSubstitution":{"type":"boolean","description":"Whether the product replaced the planned one."}},"required":["productId","position","productName","productType","epaRegNo","epaApplicable","amount","amountIsPlanned","plannedAmount","reentry","targetPests","varianceReason","isSubstitution"],"additionalProperties":false,"description":"One product on a chemical application record."},"ChemicalWeather":{"type":"object","properties":{"temperatureF":{"type":["number","null"],"description":"Temperature, °F."},"windSpeedMph":{"type":["number","null"],"description":"Wind speed, mph."},"windDirectionDeg":{"type":["number","null"],"description":"Wind direction, degrees from north."},"humidityPct":{"type":["number","null"],"description":"Relative humidity, %."},"precipitationIn":{"type":["number","null"],"description":"Precipitation, inches."},"manual":{"type":"boolean","description":"Whether the crew entered it rather than a weather service."},"soilTemperatures":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","enum":["entered","forecast"],"description":"Where it came from: a reading a person entered, or the forecast."},"temperatureF":{"type":"number","description":"Soil temperature, °F, to one decimal."},"enteredBy":{"type":["string","null"],"description":"Who entered the reading; null for the forecast or when not known."}},"required":["source","temperatureF","enteredBy"],"additionalProperties":false},"description":"Soil temperature by source, never merged. Absent when none was recorded."}},"required":["temperatureF","windSpeedMph","windDirectionDeg","humidityPct","precipitationIn","manual"],"additionalProperties":false,"description":"Weather at the time of the application."},"ChemicalApplicationRevision":{"type":"object","properties":{"revision":{"type":"integer","description":"The revision's number."},"kind":{"type":"string","enum":["completion","amendment"],"description":"`completion`: the record as first made. `amendment`: a later correction."},"at":{"type":"string","format":"date-time","description":"When it was made, ISO 8601 in UTC."},"by":{"type":["string","null"],"description":"Who made it."},"amendmentReason":{"type":["string","null"],"description":"The reason given for an amendment."},"treatedSqft":{"type":["number","null"],"description":"The area treated at this revision."},"notes":{"type":["string","null"],"description":"The notes at this revision."},"lines":{"type":"array","items":{"type":"object","properties":{"productName":{"type":"string"},"amount":{"type":["string","null"]}},"required":["productName","amount"],"additionalProperties":false},"description":"Each product and its amount at this revision."}},"required":["revision","kind","at","by","amendmentReason","treatedSqft","notes","lines"],"additionalProperties":false,"description":"One saved version of a completed record; earlier ones keep the values an amendment replaced."},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Error family, such as `invalid_request` or `permission`."},"code":{"type":"string","description":"Specific error code; see the errors page."},"message":{"type":"string","description":"A human-readable explanation."},"param":{"type":"string","description":"The input the error is about, such as `query.limit`."},"requiredScope":{"type":"string","description":"The scope the token is missing."},"requestId":{"type":"string","description":"Quote this id to support."},"docs":{"type":"string","description":"Link to the error's documentation."}},"required":["type","code","message","requestId","docs"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}},"responses":{"BadRequest":{"description":"The request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthenticated":{"description":"The token is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"SubscriptionRequired":{"description":"The workspace's subscription needs attention.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"The token is missing a required scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"No such object in this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Rate limited; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"Temporarily unavailable; retry later.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/v1/chemical-applications/{id}":{"get":{"operationId":"chemicals.applications.get","tags":["Chemical records"],"summary":"Get a chemical application record and its history","description":"One chemical application record in full (products and amounts, EPA numbers, re-entry captured at completion, weather at the start and the finish, applicator and license, treated area, posting sign, notes, who completed it) and its history: every completion and amendment, newest first, with who made it, when, the reason, and the amounts, area and notes it held. An open record has no history yet.\n\nReturns [the chemical application record object](https://docs.shortcutco.com/developers/reference/objects/chemical-application-record).","parameters":[{"name":"id","in":"path","required":true,"description":"The object's id.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success.","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ChemicalApplicationRecordWithHistory"},"meta":{"type":"object","properties":{},"additionalProperties":true,"description":"Facts about this request beside the object, such as `alreadyReminded` on a repeated reminder. Present only when there is something to report."}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"402":{"$ref":"#/components/responses/SubscriptionRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}}}}
```

## List completed visits with no chemical record

> Completed visits between \`from\` and \`to\` (default the last 30 days; at most 400 days) whose chemical service has no application record at all (\`what: service\`), and chemical add-ons done on a completed visit with none (\`what: add\_on\`), oldest first, up to 200. A visit completed before its service was set up as chemical is left out. Records started and not finished are \`GET /v1/chemical-applications?status=open\`.

```json
{"openapi":"3.1.0","info":{"title":"Shortcut API","version":"v1"},"tags":[{"name":"Chemical records","description":"A chemical application is the record a crew completes after applying fertilizer, weed control, or pest control: products and amounts, EPA numbers, applicator and license, weather, and re-entry. Records can be read by customer, or across customers by date with the ones still open, each with its amendment history. The product library holds each product's EPA number, re-entry rule, fertilizer analysis, after-care text and label link; a label's signal word, restrictions and first aid are not stored.\n\nFields: [The chemical application object](https://docs.shortcutco.com/developers/reference/objects/chemical-application)."}],"servers":[{"url":"https://api.shortcutco.com","description":"Production"}],"security":[{"bearerAuth":["customers:read","chemicals:read","visits:read"]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"scut_<env>_<id>_<secret>","description":"A workspace API token. Each operation lists the scopes it needs; `write` implies `read`, and `send`/`complete` are never implied."}},"headers":{"RateLimitLimit":{"schema":{"type":"integer"},"description":"Requests allowed in the tightest window."},"RateLimitRemaining":{"schema":{"type":"integer"},"description":"Requests left in that window."},"RateLimitReset":{"schema":{"type":"integer"},"description":"Seconds until that window resets."}},"responses":{"BadRequest":{"description":"The request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthenticated":{"description":"The token is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"SubscriptionRequired":{"description":"The workspace's subscription needs attention.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"The token is missing a required scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"No such object in this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Rate limited; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"Temporarily unavailable; retry later.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Error family, such as `invalid_request` or `permission`."},"code":{"type":"string","description":"Specific error code; see the errors page."},"message":{"type":"string","description":"A human-readable explanation."},"param":{"type":"string","description":"The input the error is about, such as `query.limit`."},"requiredScope":{"type":"string","description":"The scope the token is missing."},"requestId":{"type":"string","description":"Quote this id to support."},"docs":{"type":"string","description":"Link to the error's documentation."}},"required":["type","code","message","requestId","docs"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}},"paths":{"/v1/chemical-applications/missing":{"get":{"operationId":"chemicals.applications.missing.list","tags":["Chemical records"],"summary":"List completed visits with no chemical record","description":"Completed visits between `from` and `to` (default the last 30 days; at most 400 days) whose chemical service has no application record at all (`what: service`), and chemical add-ons done on a completed visit with none (`what: add_on`), oldest first, up to 200. A visit completed before its service was set up as chemical is left out. Records started and not finished are `GET /v1/chemical-applications?status=open`.","parameters":[{"name":"from","in":"query","required":false,"description":"The first visit day (default 30 days before `to`), `YYYY-MM-DD` in the workspace's timezone.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"to","in":"query","required":false,"description":"The last visit day (default today), `YYYY-MM-DD` in the workspace's timezone.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}}],"responses":{"200":{"description":"Success.","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"from":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"to":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"visits":{"type":"array","items":{"type":"object","properties":{"visitId":{"type":"string","format":"uuid"},"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"what":{"type":"string","enum":["service","add_on"],"description":"`service`: the visit's own chemical service has no record. `add_on`: a chemical add-on done on the visit has none."},"addOnId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"jobId":{"type":"string","format":"uuid"},"jobName":{"type":"string"},"customerId":{"type":"string","format":"uuid"},"customerName":{"type":"string"},"address":{"type":["string","null"]},"effectiveTeamId":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}]},"completedById":{"anyOf":[{"type":"string","format":"uuid"},{"type":"null"}],"description":"Who completed the visit."},"completedAt":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}]}},"required":["visitId","date","what","addOnId","jobId","jobName","customerId","customerName","address","effectiveTeamId","completedById","completedAt"],"additionalProperties":false}},"truncated":{"type":"boolean","description":"True when more than 200 visits have no record."}},"required":["from","to","visits","truncated"],"additionalProperties":false},"meta":{"type":"object","properties":{},"additionalProperties":true,"description":"Facts about this request beside the object, such as `alreadyReminded` on a repeated reminder. Present only when there is something to report."}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"402":{"$ref":"#/components/responses/SubscriptionRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}}}}
```

## List chemical products

> The company's chemical product library, newest added first: each product's EPA number, re-entry rule (\`Not set\` when the label's rule was never entered), fertilizer analysis and rate, after-care text, and the current label and safety data sheet links. Active products only unless \`includeInactive\`. Costs are not included. A label's signal word, restrictions, first aid and emergency number are not stored.\
> \
> Returns a list of \[chemical product objects]\(<https://docs.shortcutco.com/developers/reference/objects/chemical-product).\\>
> \
> \*\*Errors specific to this endpoint:\*\* \[\`chemical\_tracking\_off\`]\(<https://docs.shortcutco.com/developers/concepts/errors#chemical\\_tracking\\_off>). Every endpoint can also return the \[common errors]\(<https://docs.shortcutco.com/developers/concepts/errors>).

```json
{"openapi":"3.1.0","info":{"title":"Shortcut API","version":"v1"},"tags":[{"name":"Chemical records","description":"A chemical application is the record a crew completes after applying fertilizer, weed control, or pest control: products and amounts, EPA numbers, applicator and license, weather, and re-entry. Records can be read by customer, or across customers by date with the ones still open, each with its amendment history. The product library holds each product's EPA number, re-entry rule, fertilizer analysis, after-care text and label link; a label's signal word, restrictions and first aid are not stored.\n\nFields: [The chemical application object](https://docs.shortcutco.com/developers/reference/objects/chemical-application)."}],"servers":[{"url":"https://api.shortcutco.com","description":"Production"}],"security":[{"bearerAuth":["chemicals:read"]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"scut_<env>_<id>_<secret>","description":"A workspace API token. Each operation lists the scopes it needs; `write` implies `read`, and `send`/`complete` are never implied."}},"headers":{"RateLimitLimit":{"schema":{"type":"integer"},"description":"Requests allowed in the tightest window."},"RateLimitRemaining":{"schema":{"type":"integer"},"description":"Requests left in that window."},"RateLimitReset":{"schema":{"type":"integer"},"description":"Seconds until that window resets."}},"schemas":{"ChemicalProduct":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The product's id."},"object":{"type":"string","const":"chemical_product","description":"Always `chemical_product`."},"name":{"type":"string","description":"The product's name."},"type":{"type":"string","enum":["pesticide","fertilizer","other"],"description":"What kind of product it is."},"epaRegNo":{"type":["string","null"],"description":"The EPA registration number; null for an unregistered product."},"active":{"type":"boolean","description":"Whether it can be put on programs and records today."},"unit":{"type":"string","description":"The unit it is measured in, e.g. `fl oz`."},"reentry":{"type":"string","description":"The label's re-entry rule as set on the product: `24 hours`, `Until sprays dry`, `None`, or `Not set` when no rule is stored, which never means safe."},"reentryHours":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Hours before re-entry, for a rule measured in hours."},"fertilizer":{"anyOf":[{"type":"object","properties":{"nitrogenPct":{"type":["number","null"]},"phosphorusPct":{"type":["number","null"]},"potassiumPct":{"type":["number","null"]},"rate":{"type":["string","null"],"description":"The application rate, e.g. `4 lb per 1,000 sq ft`."}},"required":["nitrogenPct","phosphorusPct","potassiumPct","rate"],"additionalProperties":false},{"type":"null"}],"description":"A fertilizer's N-P-K analysis and rate; null for other products."},"afterCare":{"type":["string","null"],"description":"The after-care instructions the company saved for customers."},"labelUrl":{"type":["string","null"],"description":"The current label: the EPA's PDF, saved from the EPA label search. Null when none was saved."},"labelEffectiveDate":{"type":["string","null"],"description":"The current label's accepted date, `YYYY-MM-DD`."},"safetyDataSheetUrl":{"type":["string","null"],"description":"The safety data sheet link on file; null when none is."}},"required":["id","object","name","type","epaRegNo","active","unit","reentry","reentryHours","fertilizer","afterCare","labelUrl","labelEffectiveDate","safetyDataSheetUrl"],"additionalProperties":false,"description":"A chemical product in the company's library."},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Error family, such as `invalid_request` or `permission`."},"code":{"type":"string","description":"Specific error code; see the errors page."},"message":{"type":"string","description":"A human-readable explanation."},"param":{"type":"string","description":"The input the error is about, such as `query.limit`."},"requiredScope":{"type":"string","description":"The scope the token is missing."},"requestId":{"type":"string","description":"Quote this id to support."},"docs":{"type":"string","description":"Link to the error's documentation."}},"required":["type","code","message","requestId","docs"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}},"responses":{"BadRequest":{"description":"The request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthenticated":{"description":"The token is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"SubscriptionRequired":{"description":"The workspace's subscription needs attention.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"The token is missing a required scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"No such object in this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Rate limited; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"Temporarily unavailable; retry later.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/v1/chemical-products":{"get":{"operationId":"chemicals.products.list","tags":["Chemical records"],"summary":"List chemical products","description":"The company's chemical product library, newest added first: each product's EPA number, re-entry rule (`Not set` when the label's rule was never entered), fertilizer analysis and rate, after-care text, and the current label and safety data sheet links. Active products only unless `includeInactive`. Costs are not included. A label's signal word, restrictions, first aid and emergency number are not stored.\n\nReturns a list of [chemical product objects](https://docs.shortcutco.com/developers/reference/objects/chemical-product).\n\n**Errors specific to this endpoint:** [`chemical_tracking_off`](https://docs.shortcutco.com/developers/concepts/errors#chemical_tracking_off). Every endpoint can also return the [common errors](https://docs.shortcutco.com/developers/concepts/errors).","parameters":[{"name":"q","in":"query","required":false,"description":"Part of a product's name or EPA number.","schema":{"type":"string","maxLength":120}},{"name":"type","in":"query","required":false,"description":"Only products of this kind.","schema":{"type":"string","enum":["pesticide","fertilizer","other"]}},{"name":"includeInactive","in":"query","required":false,"description":"`true` includes products taken off the library.","schema":{"anyOf":[{"type":"boolean"},{"type":"string","enum":["true","false"]}]}},{"name":"limit","in":"query","required":false,"description":"How many items to return, 1-200. Defaults to 50.","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","required":false,"description":"The `meta.nextCursor` from the previous page. Omit it for the first page.","schema":{"type":"string","minLength":1,"maxLength":4096}}],"responses":{"200":{"description":"Success.","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ChemicalProduct"}},"meta":{"type":"object","properties":{"nextCursor":{"type":["string","null"],"description":"Pass as `cursor` to get the next page; null on the last page."},"hasMore":{"type":"boolean","description":"Whether another page exists."}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"402":{"$ref":"#/components/responses/SubscriptionRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}}}}
```

## Get a chemical product

> One chemical product from the library: EPA number, re-entry rule (\`Not set\` when the label's rule was never entered), fertilizer analysis and rate, after-care text, and the current label and safety data sheet links. Costs are not included. A label's signal word, restrictions, first aid and emergency number are not stored.\
> \
> Returns \[the chemical product object]\(<https://docs.shortcutco.com/developers/reference/objects/chemical-product).\\>
> \
> \*\*Errors specific to this endpoint:\*\* \[\`chemical\_tracking\_off\`]\(<https://docs.shortcutco.com/developers/concepts/errors#chemical\\_tracking\\_off>). Every endpoint can also return the \[common errors]\(<https://docs.shortcutco.com/developers/concepts/errors>).

```json
{"openapi":"3.1.0","info":{"title":"Shortcut API","version":"v1"},"tags":[{"name":"Chemical records","description":"A chemical application is the record a crew completes after applying fertilizer, weed control, or pest control: products and amounts, EPA numbers, applicator and license, weather, and re-entry. Records can be read by customer, or across customers by date with the ones still open, each with its amendment history. The product library holds each product's EPA number, re-entry rule, fertilizer analysis, after-care text and label link; a label's signal word, restrictions and first aid are not stored.\n\nFields: [The chemical application object](https://docs.shortcutco.com/developers/reference/objects/chemical-application)."}],"servers":[{"url":"https://api.shortcutco.com","description":"Production"}],"security":[{"bearerAuth":["chemicals:read"]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"scut_<env>_<id>_<secret>","description":"A workspace API token. Each operation lists the scopes it needs; `write` implies `read`, and `send`/`complete` are never implied."}},"headers":{"RateLimitLimit":{"schema":{"type":"integer"},"description":"Requests allowed in the tightest window."},"RateLimitRemaining":{"schema":{"type":"integer"},"description":"Requests left in that window."},"RateLimitReset":{"schema":{"type":"integer"},"description":"Seconds until that window resets."}},"schemas":{"ChemicalProduct":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The product's id."},"object":{"type":"string","const":"chemical_product","description":"Always `chemical_product`."},"name":{"type":"string","description":"The product's name."},"type":{"type":"string","enum":["pesticide","fertilizer","other"],"description":"What kind of product it is."},"epaRegNo":{"type":["string","null"],"description":"The EPA registration number; null for an unregistered product."},"active":{"type":"boolean","description":"Whether it can be put on programs and records today."},"unit":{"type":"string","description":"The unit it is measured in, e.g. `fl oz`."},"reentry":{"type":"string","description":"The label's re-entry rule as set on the product: `24 hours`, `Until sprays dry`, `None`, or `Not set` when no rule is stored, which never means safe."},"reentryHours":{"anyOf":[{"type":"integer"},{"type":"null"}],"description":"Hours before re-entry, for a rule measured in hours."},"fertilizer":{"anyOf":[{"type":"object","properties":{"nitrogenPct":{"type":["number","null"]},"phosphorusPct":{"type":["number","null"]},"potassiumPct":{"type":["number","null"]},"rate":{"type":["string","null"],"description":"The application rate, e.g. `4 lb per 1,000 sq ft`."}},"required":["nitrogenPct","phosphorusPct","potassiumPct","rate"],"additionalProperties":false},{"type":"null"}],"description":"A fertilizer's N-P-K analysis and rate; null for other products."},"afterCare":{"type":["string","null"],"description":"The after-care instructions the company saved for customers."},"labelUrl":{"type":["string","null"],"description":"The current label: the EPA's PDF, saved from the EPA label search. Null when none was saved."},"labelEffectiveDate":{"type":["string","null"],"description":"The current label's accepted date, `YYYY-MM-DD`."},"safetyDataSheetUrl":{"type":["string","null"],"description":"The safety data sheet link on file; null when none is."}},"required":["id","object","name","type","epaRegNo","active","unit","reentry","reentryHours","fertilizer","afterCare","labelUrl","labelEffectiveDate","safetyDataSheetUrl"],"additionalProperties":false,"description":"A chemical product in the company's library."},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Error family, such as `invalid_request` or `permission`."},"code":{"type":"string","description":"Specific error code; see the errors page."},"message":{"type":"string","description":"A human-readable explanation."},"param":{"type":"string","description":"The input the error is about, such as `query.limit`."},"requiredScope":{"type":"string","description":"The scope the token is missing."},"requestId":{"type":"string","description":"Quote this id to support."},"docs":{"type":"string","description":"Link to the error's documentation."}},"required":["type","code","message","requestId","docs"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}},"responses":{"BadRequest":{"description":"The request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthenticated":{"description":"The token is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"SubscriptionRequired":{"description":"The workspace's subscription needs attention.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"The token is missing a required scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"No such object in this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Rate limited; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"Temporarily unavailable; retry later.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/v1/chemical-products/{id}":{"get":{"operationId":"chemicals.products.get","tags":["Chemical records"],"summary":"Get a chemical product","description":"One chemical product from the library: EPA number, re-entry rule (`Not set` when the label's rule was never entered), fertilizer analysis and rate, after-care text, and the current label and safety data sheet links. Costs are not included. A label's signal word, restrictions, first aid and emergency number are not stored.\n\nReturns [the chemical product object](https://docs.shortcutco.com/developers/reference/objects/chemical-product).\n\n**Errors specific to this endpoint:** [`chemical_tracking_off`](https://docs.shortcutco.com/developers/concepts/errors#chemical_tracking_off). Every endpoint can also return the [common errors](https://docs.shortcutco.com/developers/concepts/errors).","parameters":[{"name":"id","in":"path","required":true,"description":"The object's id.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success.","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ChemicalProduct"},"meta":{"type":"object","properties":{},"additionalProperties":true,"description":"Facts about this request beside the object, such as `alreadyReminded` on a repeated reminder. Present only when there is something to report."}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"402":{"$ref":"#/components/responses/SubscriptionRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}}}}
```

## List a customer's chemical applications

> The customer's completed chemical application records, newest first, at their latest revision: products and amounts, EPA numbers, applicator and license, weather, and re-entry.\
> \
> Returns a list of \[chemical application objects]\(<https://docs.shortcutco.com/developers/reference/objects/chemical-application>).

```json
{"openapi":"3.1.0","info":{"title":"Shortcut API","version":"v1"},"tags":[{"name":"Chemical records","description":"A chemical application is the record a crew completes after applying fertilizer, weed control, or pest control: products and amounts, EPA numbers, applicator and license, weather, and re-entry. Records can be read by customer, or across customers by date with the ones still open, each with its amendment history. The product library holds each product's EPA number, re-entry rule, fertilizer analysis, after-care text and label link; a label's signal word, restrictions and first aid are not stored.\n\nFields: [The chemical application object](https://docs.shortcutco.com/developers/reference/objects/chemical-application)."}],"servers":[{"url":"https://api.shortcutco.com","description":"Production"}],"security":[{"bearerAuth":["customers:read","chemicals:read"]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"scut_<env>_<id>_<secret>","description":"A workspace API token. Each operation lists the scopes it needs; `write` implies `read`, and `send`/`complete` are never implied."}},"headers":{"RateLimitLimit":{"schema":{"type":"integer"},"description":"Requests allowed in the tightest window."},"RateLimitRemaining":{"schema":{"type":"integer"},"description":"Requests left in that window."},"RateLimitReset":{"schema":{"type":"integer"},"description":"Seconds until that window resets."}},"schemas":{"ChemicalApplication":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The application's id."},"object":{"type":"string","const":"chemical_application","description":"Always `chemical_application`."},"customerId":{"type":"string","format":"uuid","description":"The customer it was applied for."},"visitId":{"type":"string","format":"uuid","description":"The visit it was applied on."},"applicationDate":{"type":"string","description":"The day it was applied, `YYYY-MM-DD` in the workspace's timezone."},"completedAt":{"type":"string","format":"date-time","description":"When the record was completed, ISO 8601 in UTC."},"serviceName":{"type":"string","description":"The service it was part of."},"propertyAddress":{"type":["string","null"],"description":"The property it was applied at."},"treatedSqft":{"type":["number","null"],"description":"The area treated, in square feet."},"applicatorName":{"type":["string","null"],"description":"Who applied it."},"applicatorLicense":{"type":["string","null"],"description":"Their applicator license number."},"applicatorLicenseIsToday":{"type":"boolean","description":"True when the record holds no license of its own and `applicatorLicense` is the person's license today, not the one stamped at completion."},"lines":{"type":"array","items":{"$ref":"#/components/schemas/ChemicalApplicationLine"},"description":"The products applied."},"weather":{"anyOf":[{"$ref":"#/components/schemas/ChemicalWeather"},{"type":"null"}],"description":"Weather at the time, when recorded."},"reentry":{"type":["string","null"],"description":"The office's re-entry summary, e.g. `Keep off until dry`."},"postingSignPlaced":{"type":["boolean","null"],"description":"Whether the crew placed a posting sign; null when not asked."},"notes":{"type":["string","null"],"description":"The crew's notes on the application."},"revision":{"type":"integer","description":"The record's revision: 1 when never amended."},"amendmentReason":{"type":["string","null"],"description":"Why the latest amendment was made."}},"required":["id","object","customerId","visitId","applicationDate","completedAt","serviceName","propertyAddress","treatedSqft","applicatorName","applicatorLicense","applicatorLicenseIsToday","lines","weather","reentry","postingSignPlaced","notes","revision","amendmentReason"],"additionalProperties":false,"description":"A completed chemical application record."},"ChemicalApplicationLine":{"type":"object","properties":{"productName":{"type":"string","description":"The product applied."},"productType":{"anyOf":[{"type":"string","enum":["fertilizer","pesticide","other"]},{"type":"null"}],"description":"What kind of product it is."},"epaRegNo":{"type":["string","null"],"description":"The EPA registration number, when the product has one."},"epaApplicable":{"type":"boolean","description":"Whether state filing rules treat the product as EPA-registered."},"amount":{"type":["string","null"],"description":"How much was applied, e.g. `2 fl oz`: the recorded amount, else the planned one."},"amountIsPlanned":{"type":"boolean","description":"True when `amount` is the planned amount because none was recorded."},"targetPests":{"type":["string","null"],"description":"What the product targets."},"reentryKind":{"type":["string","null"],"description":"The label's re-entry rule captured at completion; null when it was never set."},"reentryHours":{"type":["number","null"],"description":"Hours before re-entry, for a rule measured in hours."},"varianceReason":{"type":["string","null"],"description":"Why the application differed from the plan, when it did."},"isSubstitution":{"type":"boolean","description":"Whether the product replaced the planned one."}},"required":["productName","productType","epaRegNo","epaApplicable","amount","amountIsPlanned","targetPests","reentryKind","reentryHours","varianceReason","isSubstitution"],"additionalProperties":false,"description":"One product on a chemical application record."},"ChemicalWeather":{"type":"object","properties":{"temperatureF":{"type":["number","null"],"description":"Temperature, °F."},"windSpeedMph":{"type":["number","null"],"description":"Wind speed, mph."},"windDirectionDeg":{"type":["number","null"],"description":"Wind direction, degrees from north."},"humidityPct":{"type":["number","null"],"description":"Relative humidity, %."},"precipitationIn":{"type":["number","null"],"description":"Precipitation, inches."},"manual":{"type":"boolean","description":"Whether the crew entered it rather than a weather service."},"soilTemperatures":{"type":"array","items":{"type":"object","properties":{"source":{"type":"string","enum":["entered","forecast"],"description":"Where it came from: a reading a person entered, or the forecast."},"temperatureF":{"type":"number","description":"Soil temperature, °F, to one decimal."},"enteredBy":{"type":["string","null"],"description":"Who entered the reading; null for the forecast or when not known."}},"required":["source","temperatureF","enteredBy"],"additionalProperties":false},"description":"Soil temperature by source, never merged. Absent when none was recorded."}},"required":["temperatureF","windSpeedMph","windDirectionDeg","humidityPct","precipitationIn","manual"],"additionalProperties":false,"description":"Weather at the time of the application."},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Error family, such as `invalid_request` or `permission`."},"code":{"type":"string","description":"Specific error code; see the errors page."},"message":{"type":"string","description":"A human-readable explanation."},"param":{"type":"string","description":"The input the error is about, such as `query.limit`."},"requiredScope":{"type":"string","description":"The scope the token is missing."},"requestId":{"type":"string","description":"Quote this id to support."},"docs":{"type":"string","description":"Link to the error's documentation."}},"required":["type","code","message","requestId","docs"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}},"responses":{"BadRequest":{"description":"The request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthenticated":{"description":"The token is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"SubscriptionRequired":{"description":"The workspace's subscription needs attention.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"The token is missing a required scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"No such object in this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Rate limited; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"Temporarily unavailable; retry later.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/v1/customers/{id}/chemical-applications":{"get":{"operationId":"customers.chemical_applications.list","tags":["Chemical records"],"summary":"List a customer's chemical applications","description":"The customer's completed chemical application records, newest first, at their latest revision: products and amounts, EPA numbers, applicator and license, weather, and re-entry.\n\nReturns a list of [chemical application objects](https://docs.shortcutco.com/developers/reference/objects/chemical-application).","parameters":[{"name":"id","in":"path","required":true,"description":"The object's id.","schema":{"type":"string","format":"uuid"}},{"name":"limit","in":"query","required":false,"description":"How many items to return, 1-200. Defaults to 50.","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","required":false,"description":"The `meta.nextCursor` from the previous page. Omit it for the first page.","schema":{"type":"string","minLength":1,"maxLength":4096}}],"responses":{"200":{"description":"Success.","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ChemicalApplication"}},"meta":{"type":"object","properties":{"nextCursor":{"type":["string","null"],"description":"Pass as `cursor` to get the next page; null on the last page."},"hasMore":{"type":"boolean","description":"Whether another page exists."}},"required":["nextCursor","hasMore"],"additionalProperties":false}},"required":["data","meta"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"402":{"$ref":"#/components/responses/SubscriptionRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}}}}
```

## Read each crew's planned product for a day

> Each crew's planned chemical product for a day (default today), as Dispatch's Day Brief works it out: per mix, the stops on it, the measured area, and each product's rate and planned total; then the stops the totals leave out (another mix, a chemical add-on, no measured area). Planned amounts only, never what was applied. \`available\` is false when the company has chemical tracking off, its chemical setup unfinished, or no plan with chemical workflows. Filter to one crew with \`teamId\`.

```json
{"openapi":"3.1.0","info":{"title":"Shortcut API","version":"v1"},"tags":[{"name":"Chemical records","description":"A chemical application is the record a crew completes after applying fertilizer, weed control, or pest control: products and amounts, EPA numbers, applicator and license, weather, and re-entry. Records can be read by customer, or across customers by date with the ones still open, each with its amendment history. The product library holds each product's EPA number, re-entry rule, fertilizer analysis, after-care text and label link; a label's signal word, restrictions and first aid are not stored.\n\nFields: [The chemical application object](https://docs.shortcutco.com/developers/reference/objects/chemical-application)."}],"servers":[{"url":"https://api.shortcutco.com","description":"Production"}],"security":[{"bearerAuth":["visits:read","chemicals:read","teams:read"]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"scut_<env>_<id>_<secret>","description":"A workspace API token. Each operation lists the scopes it needs; `write` implies `read`, and `send`/`complete` are never implied."}},"headers":{"RateLimitLimit":{"schema":{"type":"integer"},"description":"Requests allowed in the tightest window."},"RateLimitRemaining":{"schema":{"type":"integer"},"description":"Requests left in that window."},"RateLimitReset":{"schema":{"type":"integer"},"description":"Seconds until that window resets."}},"responses":{"BadRequest":{"description":"The request is invalid.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthenticated":{"description":"The token is missing, invalid, expired, or revoked.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"SubscriptionRequired":{"description":"The workspace's subscription needs attention.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Forbidden":{"description":"The token is missing a required scope.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"No such object in this workspace.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"RateLimited":{"description":"Rate limited; see Retry-After.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"InternalError":{"description":"Internal error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unavailable":{"description":"Temporarily unavailable; retry later.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"type":{"type":"string","description":"Error family, such as `invalid_request` or `permission`."},"code":{"type":"string","description":"Specific error code; see the errors page."},"message":{"type":"string","description":"A human-readable explanation."},"param":{"type":"string","description":"The input the error is about, such as `query.limit`."},"requiredScope":{"type":"string","description":"The scope the token is missing."},"requestId":{"type":"string","description":"Quote this id to support."},"docs":{"type":"string","description":"Link to the error's documentation."}},"required":["type","code","message","requestId","docs"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}},"paths":{"/v1/dispatch/day-loads":{"get":{"operationId":"dispatch.day_loads.get","tags":["Chemical records"],"summary":"Read each crew's planned product for a day","description":"Each crew's planned chemical product for a day (default today), as Dispatch's Day Brief works it out: per mix, the stops on it, the measured area, and each product's rate and planned total; then the stops the totals leave out (another mix, a chemical add-on, no measured area). Planned amounts only, never what was applied. `available` is false when the company has chemical tracking off, its chemical setup unfinished, or no plan with chemical workflows. Filter to one crew with `teamId`.","parameters":[{"name":"date","in":"query","required":false,"description":"The day (default today), `YYYY-MM-DD` in the workspace's timezone.","schema":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},{"name":"teamId","in":"query","required":false,"description":"One crew's load only.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Success.","headers":{"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"date":{"type":"string"},"available":{"type":"boolean","description":"False when the company has chemical tracking off, its setup unfinished, or no plan with chemical workflows."},"crews":{"type":"array","items":{"type":"object","properties":{"teamId":{"type":["string","null"],"description":"The crew; null for stops with no crew yet."},"teamName":{"type":"string"},"stopCount":{"type":"integer","description":"Every open or done stop on the crew's day, chemical or not."},"chemicalStopCount":{"type":"integer"},"mixes":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"\"Round 3 · Weed & Feed\", else the service's name."},"serviceName":{"type":"string"},"basis":{"type":"string","enum":["fixed_amount","per_1000_sqft","spot_treatment"]},"stopCount":{"type":"integer"},"measuredStopCount":{"type":"integer","description":"Measured stops counted in the totals (per_1000_sqft only)."},"measuredSqft":{"type":["number","null"],"description":"Treated area of the measured stops (per_1000_sqft only), else null."},"unmeasuredCount":{"type":"integer","description":"Per-1,000 stops with no usable area: left out of the area and the totals."},"products":{"type":"array","items":{"type":"object","properties":{"productId":{"type":"string"},"name":{"type":"string"},"epaRegNo":{"type":["string","null"]},"rate":{"type":"string","description":"Rate per 1,000 sq ft (per_1000_sqft), per stop (fixed_amount), or the default for spot treatment."},"unit":{"type":"string"},"total":{"type":["string","null"],"description":"Planned total for this crew's stops on this mix; null for spot treatment."},"totalUnit":{"type":["string","null"]}},"required":["productId","name","epaRegNo","rate","unit","total","totalUnit"],"additionalProperties":false}},"visitIds":{"type":"array","items":{"type":"string"}}},"required":["label","serviceName","basis","stopCount","measuredStopCount","measuredSqft","unmeasuredCount","products","visitIds"],"additionalProperties":false},"description":"The primary mix first (most stops), then the rest."},"exceptions":{"type":"array","items":{"type":"object","properties":{"visitId":{"type":"string"},"kind":{"type":"string","enum":["chemical_add_on","other_mix","unmeasured"]},"detail":{"type":["string","null"],"description":"Other mix: its label. Add-on: the add-on's name. Unmeasured: null."}},"required":["visitId","kind","detail"],"additionalProperties":false},"description":"Stops on another mix, chemical add-ons, and unmeasured stops, in route order."}},"required":["teamId","teamName","stopCount","chemicalStopCount","mixes","exceptions"],"additionalProperties":false}},"note":{"type":"string"}},"required":["date","available","crews","note"],"additionalProperties":false},"meta":{"type":"object","properties":{},"additionalProperties":true,"description":"Facts about this request beside the object, such as `alreadyReminded` on a repeated reminder. Present only when there is something to report."}},"required":["data"],"additionalProperties":false}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthenticated"},"402":{"$ref":"#/components/responses/SubscriptionRequired"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"},"429":{"$ref":"#/components/responses/RateLimited"},"500":{"$ref":"#/components/responses/InternalError"},"503":{"$ref":"#/components/responses/Unavailable"}}}}}}
```
