---
schema_version: "1"
id: 4df968341e221cbd1448723383722fed3ecc45e8a2af0f21859810d6326abaea
title: Visit
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/mfg_api_devguide/sforce_api_objects_visit.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.mfg_api_devguide.meta/mfg_api_devguide/sforce_api_objects_visit.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 269eb543cbf3cf5dd109a69a00196da428b5a2a72850c746e731834e5a25d66d
description: Represents information about a visit that a manager schedules for a field rep to perform, usually at distributor, supplier, and partner locations. This object is available in API version 56.0 and later.
---
# Visit

Represents information about a visit that a manager schedules for a field rep to perform, usually at distributor, supplier, and partner locations. This object is available in API version 56.0 and later.

## Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert()

## Fields

### AccountId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The account associated with the visit.
    
    This field is a relationship field.
- **Relationship Name**: Account
- **Refers To**: Account

### ActualVisitEndTime

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The date and time when the visit ended.

### ActualVisitStartTime

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The date and time when the visit started.

### AddressId

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The address associated with the visit.
    
    This field is a relationship field.
- **Relationship Name**: Address
- **Refers To**: Address

### ContactId

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The contact associated with the visit.
    
    This field is a relationship field.
- **Relationship Name**: Contact
- **Refers To**: Contact

### ContextId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The purpose of the visit.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: Context
- **Refers To**: AcctMgrTarget, AdvAcctForecastSetPartner, AdvAcctForecastSetUse, Asset, Case, Claim, Data\_Processing\_Engine\_Node\_Metric\_\_c, ManufacturingProgram, RebateProgram, SalesAgreement, ServiceAppointment, Vehicle, omnistudio\_\_CardFrameworkConfiguration\_\_c, omnistudio\_\_DRBatchQueue\_\_c, omnistudio\_\_DRBulkData\_\_c, omnistudio\_\_DREncryption\_\_c, omnistudio\_\_DRWorker\_\_c, omnistudio\_\_Interface\_DRGeneric\_\_c, omnistudio\_\_TestResult\_\_c, omnistudio\_\_TriggerSetup\_\_c, omnistudio\_\_UISettings\_\_c, omnistudio\_\_VlocityDataPack\_\_c, omnistudio\_\_VlocityDocuSignTemplate\_\_c, omnistudio\_\_VlocityErrorLogEntry\_\_c, omnistudio\_\_VlocityScheduledJob\_\_c, omnistudio\_\_VlocityTrackingEntry\_\_c

### CurrencyIsoCode

- **Type**: picklist
- **Properties**: Create, Defaulted on create, Filter, Group, Nillable, Restricted picklist, Sort, Update
- **Description**: Currency of the sales agreement.
- **Default value**: USD
- **Possible values**:
    - ARS—Argentine Peso
    - AUD—Australian Dollar
    - BBD—Barbados Dollar
    - BHD—Bahraini Dinar
    - BMD—Bermuda Dollar
    - BRL—Brazilian Real
    - CAD—Canadian Dollar
    - CLP—Chilean Peso
    - CNY—Chinese Yuan
    - CRC—Costa Rica Colon
    - CZK—Czech Koruna
    - DKK—Danish Krone
    - DOP—Dominican Peso
    - EUR—Euro
    - FJD—Fiji Dollar
    - GBP—British Pound
    - GTQ—Guatemala Quetzal
    - HKD—Hong Kong Dollar
    - HRK—Kuna
    - HUF—Hungarian Forint
    - IDR—Indonesian Rupiah
    - ILS—Israeli Shekel
    - ISK—Iceland Krona
    - JPY—Japanese Yen
    - KYD—Cayman Islands Dollar
    - MXN—Mexican Peso
    - USD—U.S. Dollar
    - VND—Vietnam Dong
    - XCD—East Caribbean Dollar
    - XPF—Pacific Franc

### InstructionDescription

- **Type**: textarea
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: Special instructions provided by a manager that the visitor refers to during a visit.

### LastReferencedDate

- **Type**: dateTime
- **Properties**: Filter, Nillable, Sort
- **Description**: The most recent date on which a user referenced this record.

### LastViewedDate

- **Type**: dateTime
- **Properties**: Filter, Nillable, Sort
- **Description**: The most recent date on which a user viewed this record.

### LocationId

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The location of the supplier, distributor, or partner where the visit must be conducted.
    
    This field is a relationship field.
- **Relationship Name**: Location
- **Refers To**: Location

### Name

- **Type**: string
- **Properties**: Autonumber, Defaulted on create, Filter, idLookup, Sort
- **Description**: Unique identifier for the visit record.

### OwnerId

- **Type**: reference
- **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update
- **Description**: ID of the visit record owner.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: Owner
- **Refers To**: Group, User

### ParentVisitId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The parent visit associated with the current visit.
    
    This field is a relationship field.
- **Relationship Name**: ParentVisit
- **Refers To**: Visit

### PlaceId

- **Type**: reference
- **Properties**: Create, Filter, Group, Sort, Update
- **Description**: ID of the place that the visitor visits.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: Place
- **Refers To**: Address, ContactPointAddress, Location

### PlannedVisitEndTime

- **Type**: dateTime
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The date and time when the visit is expected to end.

### PlannedVisitStartTime

- **Type**: dateTime
- **Properties**: Create, Filter, Sort, Update
- **Description**: The date and time when the visit is expected to start.

### ServiceResourceId

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**:
    
    This field is a relationship field.
- **Relationship Name**: ServiceResource
- **Refers To**: ServiceResource

### Status

- **Type**: picklist
- **Properties**: Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update
- **Description**: The status of the visit. Visitors can’t edit this field.
    
    The default value is Planned.
- **Default value**: Planned
- **Possible values**:
    - Abandoned
    - Completed
    - Error
    - InProgress—In Progress
    - None
    - Planned
    - Unscheduled

### StatusRemarks

- **Type**: textarea
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The reasons for abandoning or completing the visit as provided by the visitor.

### UserId

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The user associated with the visit.
    
    This field is a relationship field.
- **Relationship Name**: User
- **Refers To**: User

### VisitPriority

- **Type**: picklist
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The priority of the visit.
- **Possible values**:
    - High
    - Low
    - Medium

### VisitTypeId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The type of visit such as inspection type, or work type.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: VisitType
- **Refers To**: WorkType

### VisitorId

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The name of the person visiting the place.
    
    This field is a polymorphic relationship field.
- **Relationship Name**: Visitor
- **Refers To**: Contact, ServiceResource, User