--- title: imports.historyFields | Doing Work API description: Fields for importing history from another system (jobs with visit history, open quotes, unpaid invoices, price book, equipment, maintenance plans as. url: https://doingwork.work/docs/reference/imports-historyfields/ --- # imports.historyFields Fields for importing history from another system (jobs with visit history, open quotes, unpaid invoices, price book, equipment, maintenance plans as service-due reminders, payment history as read-only records) and the jobber and housecall_pro presets per kind. imports.historyPreview include_won also keeps won and declined quotes as history for pricing. Quote files may add a size: a Unit or UOM column with quantity, or a column whose header is the unit (Sq Ft, Square Feet, Linear Feet, LF). The preview shows that size. The description is used only when no size column is mapped. The Jobber preset is beta: its column names may not match a real export. We import what we can and skip the rest. | | | |---|---| | Who | Agents can call this | | REST | `GET /v1/imports/history/fields` | | MCP tool | `imports_historyFields` | | Writes | no | | Area | [Imports, custom fields, tags and search](https://doingwork.work/docs/reference/#imports-custom-fields-tags-and-search) | ## When to use it Fields for importing history from another system (jobs with visit history, open quotes, unpaid invoices, price book, equipment, maintenance plans as service-due reminders, payment history as read-only records) and the jobber and housecall_pro presets per kind. imports.historyPreview include_won also keeps won and declined quotes as history for pricing. ## What to tell the owner Tell them what you found in plain words. Don't read back raw fields. ## Input | Field | Type | Required | |---|---|---| | (none) | | | ## Example ```http GET https://doingwork.work/v1/imports/history/fields? ``` ## Output | Field | Type | Always there | |---|---|---| | `kinds` | array | yes | | `fields` | object | yes | | `presets` | object | yes | | `beta` | array | yes | | `note` | string | yes | ```json { "kinds": [ "..." ], "fields": {}, "presets": {}, "beta": [ "..." ], "note": "..." } ``` ## Errors | Code | Status | What to do | |---|---|---| | `invalid_input`, `invalid_token`, `rate_limited` | | Can happen on any call. See [errors](https://doingwork.work/docs/errors/). |