---
title: "Schedule Visit"
method: POST
path: "/api/field/jobs/{job_id}/visits"
tags: ["field"]
---

# Schedule Visit

`POST /api/field/jobs/{job_id}/visits`

## Request

- Base URL: `https://api.electricair.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.electricair.io/api/field/jobs/{job_id}/visits`
- Auth: none declared

## Path parameters

- `job_id` integer, required

## Request body

- VisitRequest
  - `starts_at` string, date-time, required
  - `ends_at` string, date-time, required
  - `technician_ids` integer[]
  - `tentative` boolean
  - `lead_id` integer, nullable
  - `arrival_window_start` string, date-time, nullable
  - `arrival_window_end` string, date-time, nullable
  - `notes` string
  - `allow_conflicts` boolean

## Response `200`

OK

- VisitResultSchema
  - `visit` VisitSchema, required
    - `id` integer, required
    - `job_id` integer, required
    - `starts_at` string, date-time, required
    - `ends_at` string, date-time, required
    - `arrival_window_start` string, date-time, nullable
    - `arrival_window_end` string, date-time, nullable
    - `status` string, required
    - `status_label` string, required
    - `tentative` boolean
    - `notes` string, required
    - `arrived_at` string, date-time, nullable
    - `finished_at` string, date-time, nullable
    - `crew` CrewMemberSchema[], required
      - `id` integer, required
      - `name` string, required
      - `color` string, required
      - `role` string, required
      - `team` string, required
      - `is_lead` boolean, required
      - `vehicle_name` string, nullable
  - `conflicts` string[], required

## Changes

> 22 revisions in range; 1 not diffed.

- **2026-10-28** `558d42db3b2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/changes/api/field/jobs/:job_id/visits/post.md)

---

[API](https://skmtc.dev/electricair/apis/electric-air-autoquote-api.md) - [All operations](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/llms.txt) - [OpenAPI document](https://skmtc.dev/electricair/apis/electric-air-autoquote-api/revisions/a13d832a5676?raw)