---
schema_version: "1"
id: 7790d1eb2abc959d6fe69586b70602b2903e18f82006d3a61865cfc1b1582439
title: SampleRequest
collection: legacydeveloper
version: current
locale: en-us
portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/mfg_api_devguide/sforce_api_objects_samplerequest.md
canonical_url: https://developer.salesforce.com/docs/atlas.en-us.mfg_api_devguide.meta/mfg_api_devguide/sforce_api_objects_samplerequest.htm
source_site: developer.salesforce.com
content_type: documentation
content_hash: 3c1ed0ed5102c5c898cc0c2207a220e5f1109d387b92c55e97922f3482a38d5e
description: Represents a request for product samples, including customer account details, request date and status. This object is available in API version 65.0 and later.
---
# SampleRequest

Represents a request for product samples, including customer account details, request date and status. This object is available in API version 65.0 and later.

## Supported Calls

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

## Fields

### Name

- **Type**: text
- **Properties**: Filter, Group, idLookup, Sort
- **Description**: Name of the sample request.

### Account

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The sample request to which the product is associated.

### Contact

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The sample request to which the product is associated.

### SalesRepresentative

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The sample request to which the product is associated.

### Contact

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The sample request to which the product is associated.

### Contact

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The sample request to which the product is associated.

### Contact

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The sample request to which the product is associated.

### SampleRequest

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The sample request to which the product is associated.

### SampleItemReference

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: Indicates the specific sample product which can be either a standard product or a custom product requirement.

### Product

- **Type**: reference
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: ID of the standard sample product requested in the sample request.

### ProductRequirementSpecification

- **Type**: string
- **Properties**: Create, Filter, Group, Nillable, Sort, Update
- **Description**: The unique product specification required for the sample, if not a standard product.

### ProductCategory

- **Type**: reference
- **Properties**: Create, Filter, Group, Nillable, Sort
- **Description**: The category of the sample product being requested.

### Purpose

- **Type**: text
- **Properties**: Create, Filter, Nillable, Sort, Update
- **Description**: The reason for requesting this particular product or sample.

### Quantity

- **Type**: int
- **Properties**: Filter, Group, Nillable, Sort
- **Description**: The quantity of the product or sample requested.

### UnitOfMeasure

- **Type**: string
- **Properties**: Filter, Group, Sort
- **Description**: The unit of measure for the requested sample.

### BatchNumber

- **Type**: reference
- **Properties**: Filter, Group, Sort
- **Description**: The specific product batch associated with the requested sample product.

### SalesPrice

- **Type**: currency
- **Properties**: Filter, Nillable, Sort
- **Description**: The sales price of the sample product.

### CostPrice

- **Type**: currency
- **Properties**: Filter, Nillable, Sort
- **Description**: The cost of the sample product.

### AdditionalInfo

- **Type**: text
- **Properties**: Filter, Nillable, Sort
- **Description**: The additional details or special instructions for the sample product.

### PriceBookEntry

- **Type**: reference
- **Properties**: Filter, Group, Sort
- **Description**: The price book entry defining the sample product's price.

### CostBookEntry

- **Type**: reference
- **Properties**: Filter, Nillable, Sort
- **Description**: The cost book entry defining the sample product's cost.

### ListPrice

- **Type**: currency
- **Properties**: Filter, Nillable, Sort
- **Description**: Price of a product as specified in a price book.