> 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/objects/chemical-application.md).

# The chemical application object

The chemical application object in the Shortcut API - every field, an example, and the endpoints that return it.

A completed chemical application record.

## Fields

| Field                                     | Type                                       | Description                                                                                                                                |
| ----------------------------------------- | ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`                                      | id                                         | The application's id.                                                                                                                      |
| `object`                                  | `"chemical_application"`                   | Always `chemical_application`.                                                                                                             |
| `customerId`                              | id                                         | The customer it was applied for.                                                                                                           |
| `visitId`                                 | id                                         | The visit it was applied on.                                                                                                               |
| `applicationDate`                         | string                                     | The day it was applied, `YYYY-MM-DD` in the workspace's timezone.                                                                          |
| `completedAt`                             | timestamp                                  | When the record was completed, ISO 8601 in UTC.                                                                                            |
| `serviceName`                             | string                                     | The service it was part of.                                                                                                                |
| `propertyAddress`                         | string or null                             | The property it was applied at.                                                                                                            |
| `treatedSqft`                             | number or null                             | The area treated, in square feet.                                                                                                          |
| `applicatorName`                          | string or null                             | Who applied it.                                                                                                                            |
| `applicatorLicense`                       | string or null                             | Their applicator license number.                                                                                                           |
| `applicatorLicenseIsToday`                | boolean                                    | 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`                                   | array of objects                           | The products applied.                                                                                                                      |
| `lines[].productName`                     | string                                     | The product applied.                                                                                                                       |
| `lines[].productType`                     | `fertilizer`, `pesticide`, `other` or null | What kind of product it is.                                                                                                                |
| `lines[].epaRegNo`                        | string or null                             | The EPA registration number, when the product has one.                                                                                     |
| `lines[].epaApplicable`                   | boolean                                    | Whether state filing rules treat the product as EPA-registered.                                                                            |
| `lines[].amount`                          | string or null                             | How much was applied, e.g. `2 fl oz`: the recorded amount, else the planned one.                                                           |
| `lines[].amountIsPlanned`                 | boolean                                    | True when `amount` is the planned amount because none was recorded.                                                                        |
| `lines[].targetPests`                     | string or null                             | What the product targets.                                                                                                                  |
| `lines[].reentryKind`                     | string or null                             | The label's re-entry rule captured at completion; null when it was never set.                                                              |
| `lines[].reentryHours`                    | number or null                             | Hours before re-entry, for a rule measured in hours.                                                                                       |
| `lines[].varianceReason`                  | string or null                             | Why the application differed from the plan, when it did.                                                                                   |
| `lines[].isSubstitution`                  | boolean                                    | Whether the product replaced the planned one.                                                                                              |
| `weather`                                 | object or null                             | Weather at the time, when recorded.                                                                                                        |
| `weather.temperatureF`                    | number or null                             | Temperature, °F.                                                                                                                           |
| `weather.windSpeedMph`                    | number or null                             | Wind speed, mph.                                                                                                                           |
| `weather.windDirectionDeg`                | number or null                             | Wind direction, degrees from north.                                                                                                        |
| `weather.humidityPct`                     | number or null                             | Relative humidity, %.                                                                                                                      |
| `weather.precipitationIn`                 | number or null                             | Precipitation, inches.                                                                                                                     |
| `weather.manual`                          | boolean                                    | Whether the crew entered it rather than a weather service.                                                                                 |
| `weather.soilTemperatures`                | array of objects                           | Soil temperature by source, never merged. Absent when none was recorded.                                                                   |
| `weather.soilTemperatures[].source`       | `entered`, `forecast`                      | Where it came from: a reading a person entered, or the forecast.                                                                           |
| `weather.soilTemperatures[].temperatureF` | number                                     | Soil temperature, °F, to one decimal.                                                                                                      |
| `weather.soilTemperatures[].enteredBy`    | string or null                             | Who entered the reading; null for the forecast or when not known.                                                                          |
| `reentry`                                 | string or null                             | The office's re-entry summary, e.g. `Keep off until dry`.                                                                                  |
| `postingSignPlaced`                       | boolean or null                            | Whether the crew placed a posting sign; null when not asked.                                                                               |
| `notes`                                   | string or null                             | The crew's notes on the application.                                                                                                       |
| `revision`                                | integer                                    | The record's revision: 1 when never amended.                                                                                               |
| `amendmentReason`                         | string or null                             | Why the latest amendment was made.                                                                                                         |

## Example

```json
{
  "id": "b79ccc4c-b3e7-4793-8031-42daac7b7e21",
  "object": "chemical_application",
  "customerId": "9eba8728-9b04-426f-874e-fdb6939938fd",
  "visitId": "00af132b-fcf9-4e72-8943-89b9f58dc500",
  "applicationDate": "2026-10-20",
  "completedAt": "2026-10-16T17:04:12.381Z",
  "serviceName": "Example serviceName",
  "propertyAddress": "412 Elm St, Bozeman, MT 59715",
  "treatedSqft": 45,
  "applicatorName": "Example applicatorName",
  "applicatorLicense": "Example applicatorLicense",
  "applicatorLicenseIsToday": true,
  "lines": [
    {
      "productName": "Example productName",
      "productType": "fertilizer",
      "epaRegNo": "Example epaRegNo",
      "epaApplicable": true,
      "amount": "Example amount",
      "amountIsPlanned": true,
      "targetPests": "Example targetPests",
      "reentryKind": "Example reentryKind",
      "reentryHours": 45,
      "varianceReason": "Example varianceReason",
      "isSubstitution": false
    }
  ],
  "weather": {
    "temperatureF": 45,
    "windSpeedMph": 45,
    "windDirectionDeg": 45,
    "humidityPct": 45,
    "precipitationIn": 45,
    "manual": true,
    "soilTemperatures": [
      {
        "source": "entered",
        "temperatureF": 45,
        "enteredBy": "Jordan Lee"
      }
    ]
  },
  "reentry": "Example reentry",
  "postingSignPlaced": true,
  "notes": "Example notes",
  "revision": 1,
  "amendmentReason": "Example amendmentReason"
}
```

## Endpoints

| Endpoint                                       | What it does                            |
| ---------------------------------------------- | --------------------------------------- |
| `GET /v1/customers/{id}/chemical-applications` | List a customer's chemical applications |
