Skip to content

HubSpot: Fees schemas

35 HubSpot schemas with complete fields and constraints.

← Fees operations · All schemas

Archive batch objects — fees batch Delete Fees — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents a batch input payload containing a list of simple public object IDs. This component is used when performing batch operations on multiple objects within HubSpot.
inputsarrayRequired within parentAn array of SimplePublicObjectId objects, each containing an ID of a simple public object to be processed in the batch operation.
inputs[]ModelEach itemExpand Archive a batch of contacts — request body — body inputs item

Referenced models: Archive a batch of contacts — request body — body inputs item

Batch create objects — fees batch Create Fees — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents a batch input for creating multiple simple public objects in a single request. This component is used to streamline the process of adding new objects to a HubSpot account by allowing multiple entries to be created at once.
inputsarrayRequired within parentAn array of objects to be created, each represented by a SimplePublicObjectBatchInputForCreate. Each object includes properties and associations necessary for creation.
inputs[]ModelEach itemExpand Batch create objects — fees batch Create Fees — request body — body inputs item

Referenced models: Batch create objects — fees batch Create Fees — request body — body inputs item

Batch create objects — fees batch Create Fees — request body — body inputs item

FieldTypePresenceDescription and constraints
$objectRootAn input object that contains a collection of objects to be created together in a batch.
associationsarrayRequired within parentAn array of objects representing associations between the CRM object being created and other objects. Each association is defined by a 'PublicAssociationsForObject' schema.
associations[]ModelEach itemExpand Create — fees create Fee — request body — body associations item
objectWriteTraceIdstringOptionalA string used to trace the write operation for debugging or logging purposes.
propertiesobjectRequired within parentAn object containing key-value pairs where keys are property names and values are the corresponding property values for the CRM object. Each property is a string.
Additional keys: see wildcard field
properties.*stringAdditional keys

Referenced models: Create — fees create Fee — request body — body associations item

Create — fees create Fee — request body — body

FieldTypePresenceDescription and constraints
$objectRootIs the input object used to create a new CRM object, containing the properties to be set and optional associations to link the new record with other CRM objects.
associationsarrayRequired within parentAn array of objects that define the associations between the new CRM object and other existing objects. Each association specifies the related object and the type of relationship.
associations[]ModelEach itemExpand Create — fees create Fee — request body — body associations item
propertiesobjectRequired within parentAn object containing key-value pairs representing the properties of the CRM object to be created. Each key is a property name, and the value is the property's value.
Additional keys: see wildcard field
properties.*stringAdditional keys

Referenced models: Create — fees create Fee — request body — body associations item

Create — fees create Fee — request body — body associations item

FieldTypePresenceDescription and constraints
$objectRootRepresents the associations for a specific object in HubSpot, detailing the types of associations and the related objects involved.
toModelRequired within parentExpand Read batch objects — carts batch Get Carts — request body — body inputs item
typesarrayRequired within parentAn array of association specifications, each detailing the type of association between the objects. This includes information such as the association category and type ID.
types[]ModelEach itemExpand Create meeting — request body — body associations item types item

Referenced models: Read batch objects — carts batch Get Carts — request body — body inputs item, Create meeting — request body — body associations item types item

Create — fees create Fee — response body

FieldTypePresenceDescription and constraints
$objectRootA simple public object.
archivedbooleanRequired within parentA boolean indicating whether this object is archived.
archivedAtstringOptionalThe date and time when this object was archived, in ISO 8601 format.
Format: date-time
createdAtstringRequired within parentThe date and time when this object was created, in ISO 8601 format.
Format: date-time
idstringRequired within parentThe unique identifier for this object, represented as a string.
objectWriteTraceIdstringOptionalA string used to trace the write operations on this object.
propertiesobjectRequired within parentA map of property names to their current values, represented as key-value pairs where both keys and values are strings.
Additional keys: see wildcard field
properties.*stringAdditional keys
propertiesWithHistoryobjectOptionalA map of property names to their historical values, where each value is an array of objects containing the value and the timestamp when it was recorded.
Additional keys: see wildcard field
propertiesWithHistory.*arrayAdditional keys
propertiesWithHistory.*[]ModelEach itemExpand Read — fees get Fee — response body — properties With History value item
updatedAtstringRequired within parentThe date and time when this object was last updated, in ISO 8601 format.
Format: date-time
urlstringOptionalA string representing the URL of this object.
warningsarrayOptionalAn array of warnings related to this object, where each warning includes a category, message, and context.
warnings[]ModelEach itemExpand Read — fees get Fee — response body — warnings item

Referenced models: Read — fees get Fee — response body — warnings item, Read — fees get Fee — response body — properties With History value item

GDPR Delete — fees gdpr Delete — request body — body

FieldTypePresenceDescription and constraints
$objectRootAn input that contains the information required to process a public GDPR data deletion request.
idPropertystringOptionalThe name of a property whose values are unique for this object
objectIdstringRequired within parentA string representing the unique identifier of the object to be deleted. This field is required.

List Associations — fees get Associations By To Object Type — response body

FieldTypePresenceDescription and constraints
$objectRootRepresents a paginated collection of objects that are associated with multiple labels, including the results and pagination details. This component is used when retrieving associated objects with specific labels in a forward-paging manner.
pagingModelOptionalExpand Retrieve contacts — response body — paging
resultsarrayRequired within parentAn array of objects, each representing an association with multiple labels. Each object includes details about the associated object and the types of associations.
results[]ModelEach itemExpand List Associations — fees get Associations By To Object Type — response body — results item

Referenced models: Retrieve contacts — response body — paging, List Associations — fees get Associations By To Object Type — response body — results item

List Associations — fees get Associations By To Object Type — response body — results item

FieldTypePresenceDescription and constraints
$objectRootRepresents an object that is associated with multiple other objects, with optional context.
associationTypesarrayRequired within parentAn array of association specifications with labels, detailing the types of associations and their corresponding labels. Each item in the array is an object of type AssociationSpecWithLabel.
associationTypes[]ModelEach itemExpand List Associations — fees get Associations By To Object Type — response body — results item association Types item
toObjectIdstringRequired within parentThe unique identifier of the object to which associations are being made. This is a string value.

Referenced models: List Associations — fees get Associations By To Object Type — response body — results item association Types item

List Associations — fees get Associations By To Object Type — response body — results item association Types item

FieldTypePresenceDescription and constraints
$objectRootDefines the type, direction, and details of the relationship between two CRM objects.
categorystringRequired within parentThe category of the association, indicating its origin. Valid values include 'HUBSPOT_DEFINED', 'USER_DEFINED', 'INTEGRATOR_DEFINED', and 'WORK'.
Known values: HUBSPOT_DEFINED, INTEGRATOR_DEFINED, USER_DEFINED, WORK
fromObjectTypeIdstringOptionalThe object type ID of the source object in the association.
labelstringOptionalA string label that describes the association.
toObjectTypeIdstringOptionalThe object type ID of the target object in the association.
typeIdJSONRequired within parent
typeId (anyOf 1)integerAlternativeAn integer representing the unique identifier for the type of association.
Format: int32
typeId (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

List — fees get Fees — response body

FieldTypePresenceDescription and constraints
$objectRootRepresents a paginated collection response that includes simple public objects with their associations. This component is used to handle the results and pagination details when retrieving a list of objects from the API.
pagingModelOptionalExpand Retrieve contacts — response body — paging
resultsarrayRequired within parentAn array of SimplePublicObjectWithAssociations, each representing a CRM object with its associated data.
results[]ModelEach itemExpand Read — fees get Fee — response body

Referenced models: Retrieve contacts — response body — paging, Read — fees get Fee — response body

Merge objects — fees merge — request body — body

FieldTypePresenceDescription and constraints
$objectRootInput data for merging two records.
objectIdToMergestringRequired within parentThe unique identifier of the object that will be merged into the primary object. This is a string.
primaryObjectIdstringRequired within parentThe unique identifier of the object that will remain as the primary object after the merge. This is a string.

Read batch objects — fees batch Get Fees — request body — body

FieldTypePresenceDescription and constraints
$objectRootSpecifies the input for reading a batch of CRM objects, including arrays of object IDs, requested property names (with optional history), and an optional unique identifying property.
idPropertystringOptionalWhen using a custom unique value property to retrieve records, the name of the property. Do not include this parameter if retrieving by record ID.
inputsarrayRequired within parentAn array of SimplePublicObjectId objects, each containing an ID that identifies the CRM objects to be read.
inputs[]ModelEach itemExpand Archive a batch of contacts — request body — body inputs item
propertiesarrayRequired within parentAn array of strings representing the properties to be returned in the response. If any of the specified properties are not present on the requested objects, they will be ignored.
properties[]stringEach item
propertiesWithHistoryarrayRequired within parentAn array of strings representing the properties to be returned along with their history of previous values. If any of the specified properties are not present on the requested objects, they will be ignored.
propertiesWithHistory[]stringEach item

Referenced models: Archive a batch of contacts — request body — body inputs item

Read batch objects — fees.batchGetFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item

FieldTypePresenceDescription and constraints
$objectRootRepresents a standard error response in the HubSpot API, providing detailed information about an error that occurred during an API request.
categorystringRequired within parentA string indicating the category of the error.
contextobjectRequired within parentAn object containing additional context about the error, represented as a map of string keys to arrays of strings.
Additional keys: see wildcard field
context.*arrayAdditional keys
context.*[]stringEach item
errorsarrayRequired within parentAn array of ErrorDetail objects, each providing further information about specific aspects of the error.
errors[]ModelEach itemExpand Batch insert events — response body — errors item errors item
idstringOptionalA string that uniquely identifies the error instance.
linksobjectRequired within parentAn object containing a map of link names to associated URIs, providing documentation or recommended remediation steps related to the error.
Additional keys: see wildcard field
links.*stringAdditional keys
messagestringRequired within parentA string containing a human-readable message that describes the error.
statusstringRequired within parentA string representing the status of the error.
subCategoryobjectOptionalAn object providing additional categorization of the error, allowing for more specific error details.

Referenced models: Batch insert events — response body — errors item errors item

Read batch objects — fees.batchGetFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Fees Batch Response Simple Public Object

FieldTypePresenceDescription and constraints
$objectRootA public object batch response object
completedAtstringRequired within parentThe date and time when the batch operation was completed, in ISO 8601 format.
Format: date-time
linksobjectOptionalA map of link names to associated URIs, providing additional information or actions related to the batch operation.
Additional keys: see wildcard field
links.*stringAdditional keys
requestedAtstringOptionalThe date and time when the batch operation was requested, in ISO 8601 format.
Format: date-time
resultsarrayRequired within parentAn array of SimplePublicObject items representing the results of the batch operation.
results[]ModelEach itemExpand Create — fees create Fee — response body
startedAtstringRequired within parentThe date and time when the batch operation started, in ISO 8601 format.
Format: date-time
statusstringRequired within parentThe current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
Known values: CANCELED, COMPLETE, PENDING, PROCESSING

Referenced models: Create — fees create Fee — response body

Read batch objects — fees.batchGetFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Fees Batch Response Simple Public Object With Errors

FieldTypePresenceDescription and constraints
$objectRootRepresents the result of a batch operation on CRM objects, including the processing status, batch results, timestamps, and a list of any errors encountered during the operation.
completedAtstringRequired within parentThe date and time when the batch operation was completed, in ISO 8601 format.
Format: date-time
errorsarrayOptionalAn array of StandardError objects detailing any errors that occurred during the batch operation.
errors[]ModelEach itemExpand Read batch objects — fees.batchGetFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item
linksobjectOptionalA map of link names to associated URIs for additional information or actions related to the batch operation.
Additional keys: see wildcard field
links.*stringAdditional keys
numErrorsJSONOptional
numErrors (anyOf 1)integerAlternativeThe number of errors encountered during the batch operation.
Format: int32
numErrors (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
requestedAtstringOptionalThe date and time when the batch operation was requested, in ISO 8601 format.
Format: date-time
resultsarrayRequired within parentAn array of SimplePublicObject items representing the results of the batch operation.
results[]ModelEach itemExpand Create — fees create Fee — response body
startedAtstringRequired within parentThe date and time when the batch operation started, in ISO 8601 format.
Format: date-time
statusstringRequired within parentThe current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
Known values: CANCELED, COMPLETE, PENDING, PROCESSING

Referenced models: Read batch objects — fees.batchGetFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item, Create — fees create Fee — response body

Read — fees get Fee — response body

FieldTypePresenceDescription and constraints
$objectRootRepresents a CRM object along with its properties, timestamps, and a set of associated object IDs grouped by association type.
archivedbooleanRequired within parentA boolean indicating whether this object has been archived.
archivedAtstringOptionalThe date and time when this object was archived, in ISO 8601 format.
Format: date-time
associationsobjectOptionalA map of associated object types to their associated IDs, representing the relationships this object has with other objects.
Additional keys: see wildcard field
associations.*ModelAdditional keysExpand Read — fees get Fee — response body — associations value
createdAtstringRequired within parentThe date and time when this object was created, in ISO 8601 format.
Format: date-time
idstringRequired within parentThe unique identifier for this object.
objectWriteTraceIdstringOptionalAn identifier used for tracing the write operations on this object.
propertiesobjectRequired within parentA map of property names to their values for this object.
Additional keys: see wildcard field
properties.*stringAdditional keys
propertiesWithHistoryobjectOptionalA map of property names to their values along with a history of changes, including timestamps.
Additional keys: see wildcard field
propertiesWithHistory.*arrayAdditional keys
propertiesWithHistory.*[]ModelEach itemExpand Read — fees get Fee — response body — properties With History value item
updatedAtstringRequired within parentThe date and time when this object was last updated, in ISO 8601 format.
Format: date-time
urlstringOptionalThe URL link to access this object.
warningsarrayOptionalA list of warnings related to this object, each containing a category, message, and context.
warnings[]ModelEach itemExpand Read — fees get Fee — response body — warnings item

Referenced models: Read — fees get Fee — response body — warnings item, Read — fees get Fee — response body — associations value, Read — fees get Fee — response body — properties With History value item

Read — fees get Fee — response body — associations value

FieldTypePresenceDescription and constraints
$objectRootRepresents a collection of associated IDs returned by an API request, including pagination details for navigating through the results.
pagingModelOptionalExpand Search objects — fees search Fees — response body — paging
resultsarrayRequired within parentAn array of associated IDs, each represented by an object containing the ID and type of the association.
results[]ModelEach itemExpand Read — fees get Fee — response body — associations value results item

Referenced models: Read — fees get Fee — response body — associations value results item, Search objects — fees search Fees — response body — paging

Read — fees get Fee — response body — associations value results item

FieldTypePresenceDescription and constraints
$objectRootContains the id and type of an association
idstringRequired within parentA string representing the unique identifier of the associated object.
typestringRequired within parentA string indicating the type of the associated object.

Read — fees get Fee — response body — properties With History value item

FieldTypePresenceDescription and constraints
$objectRootProperty model that includes timestamp.
sourceIdstringOptionalThe unique identifier of the source that provided the value. It is a string.
sourceLabelstringOptionalA label describing the source of the value. It is a string.
sourceTypestringRequired within parentThe type of source that provided the value. It is a string.
timestampstringRequired within parentThe date and time when the value was recorded, in ISO 8601 format.
Format: date-time
updatedByUserIdJSONOptional
updatedByUserId (anyOf 1)integerAlternativeThe ID of the user who last updated the value. It is an integer.
Format: int32
updatedByUserId (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
valuestringRequired within parentThe value of the property at the given timestamp. It is a string.

Read — fees get Fee — response body — warnings item

FieldTypePresenceDescription and constraints
$objectRootRepresents a warning message related to a public object in HubSpot, providing details about the nature and context of the warning.
categorystringRequired within parentA string indicating the category of the warning.
contextobjectRequired within parentAn object providing additional context for the warning, with string properties.
Additional keys: see wildcard field
context.*stringAdditional keys
messagestringRequired within parentA string containing the warning message.

Search objects — fees search Fees — request body — body

FieldTypePresenceDescription and constraints
$objectRootDescribes a search request
afterstringRequired within parentA string representing the paging cursor token, used to retrieve the next set of results in a paginated response.
filterGroupsarrayRequired within parentAn array of filter groups used to narrow down the search results. Each filter group contains multiple filters that are combined using logical AND operations.
filterGroups[]ModelEach itemExpand Search objects — fees search Fees — request body — body filter Groups item
limitintegerRequired within parentAn integer specifying the maximum number of results to return.
Format: int32
propertiesarrayRequired within parentAn array of strings indicating which properties of the objects should be included in the search results.
properties[]stringEach item
querystringOptionalA string used to perform a full-text search across the specified properties.
sortsarrayRequired within parentAn array of strings specifying the sorting order of the search results. Each string represents a property to sort by, optionally prefixed with a '-' to indicate descending order.
sorts[]stringEach item

Referenced models: Search objects — fees search Fees — request body — body filter Groups item

Search objects — fees search Fees — request body — body filter Groups item

FieldTypePresenceDescription and constraints
$objectRootRepresents a group of filters used to query data within HubSpot. This component is used to define criteria for filtering records in various API endpoints.
filtersarrayRequired within parentAn array of filter objects that specify the conditions to apply in the search. Each filter defines a property, an operator, and a value to match against.
filters[]ModelEach itemExpand Search objects — fees search Fees — request body — body filter Groups item filters item

Referenced models: Search objects — fees search Fees — request body — body filter Groups item filters item

Search objects — fees search Fees — request body — body filter Groups item filters item

FieldTypePresenceDescription and constraints
$objectRootDefines a single condition for searching CRM objects, specifying the property to filter on, the operator to use (such as equals, greater than, or contains), and the value(s) to compare against.
highValuestringOptionalAn optional string used for range-based filters to specify the upper bound of the range.
operatorstringRequired within parentThe operator used to compare the property value with the specified value(s). Valid operators include 'EQ', 'NEQ', 'LT', 'LTE', 'GT', 'GTE', 'BETWEEN', 'IN', 'NOT_IN', 'HAS_PROPERTY', 'NOT_HAS_PROPERTY', 'CONTAINS_TOKEN', and 'NOT_CONTAINS_TOKEN'.
One of: BETWEEN, CONTAINS_TOKEN, EQ, GT, GTE, HAS_PROPERTY, IN, LT, LTE, NEQ, NOT_CONTAINS_TOKEN, NOT_HAS_PROPERTY, NOT_IN
propertyNamestringRequired within parentThe name of the property to filter by. It is a string that specifies which property of the object is being evaluated.
valuestringOptionalThe value to compare against the specified property. It is a string used in conjunction with the operator to determine if the object meets the filter criteria.
valuesarrayOptionalAn array of strings used for filters that involve multiple values, such as 'IN' or 'NOT_IN' operators.
values[]stringEach item

Search objects — fees search Fees — response body

FieldTypePresenceDescription and constraints
$objectRootRepresents a list of simple objects returned from an API request, along with the total count of objects available.
pagingModelOptionalExpand Search objects — fees search Fees — response body — paging
resultsarrayRequired within parentAn array of SimplePublicObject items, each representing an individual CRM object.
results[]ModelEach itemExpand Create — fees create Fee — response body
totalJSONRequired within parent
total (anyOf 1)integerAlternativeThe number of available results
Format: int32
total (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Referenced models: Search objects — fees search Fees — response body — paging, Create — fees create Fee — response body

Search objects — fees search Fees — response body — paging

FieldTypePresenceDescription and constraints
$objectRootRepresents the pagination information for navigating through a list of results in the API. It provides details on how to access the previous or next set of results.
nextModelOptionalExpand Retrieve contacts — response body — paging next
prevModelOptionalExpand Search objects — fees search Fees — response body — paging prev

Referenced models: Retrieve contacts — response body — paging next, Search objects — fees search Fees — response body — paging prev

Search objects — fees search Fees — response body — paging prev

FieldTypePresenceDescription and constraints
$objectRootspecifies the paging information needed to retrieve the previous set of results in a paginated API response
beforestringRequired within parentA string token that indicates the position of the last item on the previous page.
linkstringOptionalA string URL that provides a direct link to the previous page of results.

Update batch objects — fees batch Update Fees — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents a batch input component used to handle multiple simple public objects in a single API request. This component is typically used when performing batch operations to create, update, or delete multiple records simultaneously.
inputsarrayRequired within parentAn array of SimplePublicObjectBatchInput objects, each containing the properties and identifiers for a CRM object to be updated.
inputs[]ModelEach itemExpand Update batch objects — fees batch Update Fees — request body — body inputs item

Referenced models: Update batch objects — fees batch Update Fees — request body — body inputs item

Update batch objects — fees batch Update Fees — request body — body inputs item

FieldTypePresenceDescription and constraints
$objectRootContains an array of CRM object records to be processed in a batch operation, each defined by their ID and properties.
idstringRequired within parentThe id to be updated. This can be the object id, or the unique property value of the idProperty property
idPropertystringOptionalThe name of a property whose values are unique for this object
objectWriteTraceIdstringOptionalA string used to trace the write operation for debugging or logging purposes.
propertiesobjectRequired within parentA map of property names to their values, representing the data of the CRM object. Each property is a string.
Additional keys: see wildcard field
properties.*stringAdditional keys

Update — fees update Fee — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents the input required to update a CRM object, containing an object with property names and their corresponding values.
propertiesobjectRequired within parentAn object containing key-value pairs where each key is a property name and the value is the property value. All properties are represented as strings.
Additional keys: see wildcard field
properties.*stringAdditional keys

Upsert batch objects — fees batch Upsert Fees — request body — body

FieldTypePresenceDescription and constraints
$objectRootRepresents a batch input operation for upserting simple public objects in HubSpot. This component is used to process multiple upsert operations in a single request, improving efficiency and performance.
inputsarrayRequired within parentAn array of SimplePublicObjectBatchInputUpsert objects, each representing a CRM object to be created or updated. Each object must include properties such as 'id' and 'properties'.
inputs[]ModelEach itemExpand Upsert batch objects — fees batch Upsert Fees — request body — body inputs item

Referenced models: Upsert batch objects — fees batch Upsert Fees — request body — body inputs item

Upsert batch objects — fees batch Upsert Fees — request body — body inputs item

FieldTypePresenceDescription and constraints
$objectRootRepresents an object used in batch upsert operations, containing an object’s unique identifier, its properties, and optionally the unique property name and a write trace ID.
idstringRequired within parentA string representing the unique identifier for the object.
idPropertystringOptionalThe name of a property whose values are unique for this object
objectWriteTraceIdstringOptionalAn optional string identifier used to trace the write operation for debugging or logging purposes.
propertiesobjectRequired within parentA map of property names to their values for the object. Each property is a string.
Additional keys: see wildcard field
properties.*stringAdditional keys

Upsert batch objects — fees.batchUpsertFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item

FieldTypePresenceDescription and constraints
$objectRootRepresents a CRM object that has either been created or updated (upserted)
archivedbooleanRequired within parentA boolean indicating whether this object is archived.
archivedAtstringOptionalThe date and time when this object was archived, in ISO 8601 format.
Format: date-time
createdAtstringRequired within parentThe date and time when this object was created, in ISO 8601 format.
Format: date-time
idstringRequired within parentThe unique identifier for this object, represented as a string.
newbooleanRequired within parentA boolean indicating whether this object is newly created (true) or updated (false).
objectWriteTraceIdstringOptionalA string used to trace the write operation for this object.
propertiesobjectRequired within parentA map of property names to their values for this object, with each value represented as a string.
Additional keys: see wildcard field
properties.*stringAdditional keys
propertiesWithHistoryobjectOptionalA map of property names to their historical values, where each value is an array of objects containing the value and the timestamp when it was recorded.
Additional keys: see wildcard field
propertiesWithHistory.*arrayAdditional keys
propertiesWithHistory.*[]ModelEach itemExpand Read — fees get Fee — response body — properties With History value item
updatedAtstringRequired within parentThe date and time when this object was last updated, in ISO 8601 format.
Format: date-time
urlstringOptionalA string representing the URL of this object.
warningsarrayOptionalAn array of warnings associated with this object, where each warning includes a category, message, and context.
warnings[]ModelEach itemExpand Read — fees get Fee — response body — warnings item

Referenced models: Read — fees get Fee — response body — warnings item, Read — fees get Fee — response body — properties With History value item

Upsert batch objects — fees.batchUpsertFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Fees Batch Response Simple Public Upsert Object

FieldTypePresenceDescription and constraints
$objectRootRepresents the result of a batch upsert operation, including the operation’s status, timestamps, and a list of successfully created or updated objects.
completedAtstringRequired within parentThe date and time when the batch operation was completed, in ISO 8601 format.
Format: date-time
linksobjectOptionalA map of link names to associated URIs, providing additional information about the batch operation.
Additional keys: see wildcard field
links.*stringAdditional keys
requestedAtstringOptionalThe date and time when the batch operation was requested, in ISO 8601 format.
Format: date-time
resultsarrayRequired within parentAn array of results from the batch upsert operation, each represented as a SimplePublicUpsertObject.
results[]ModelEach itemExpand Upsert batch objects — fees.batchUpsertFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item
startedAtstringRequired within parentThe date and time when the batch operation started, in ISO 8601 format.
Format: date-time
statusstringRequired within parentThe current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
Known values: CANCELED, COMPLETE, PENDING, PROCESSING

Referenced models: Upsert batch objects — fees.batchUpsertFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item

Upsert batch objects — fees.batchUpsertFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING — Fees Batch Response Simple Public Upsert Object With Errors

FieldTypePresenceDescription and constraints
$objectRootRepresents the response from a batch upsert operation, including the status, timestamps, successfully processed objects, and any errors that occurred during processing.
completedAtstringRequired within parentThe date and time when the batch operation was completed, in ISO 8601 format.
Format: date-time
errorsarrayOptionalAn array of StandardError objects detailing any errors that occurred during the batch operation.
errors[]ModelEach itemExpand Read batch objects — fees.batchGetFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item
linksobjectOptionalA map of link names to associated URIs, providing additional context or navigation related to the batch operation.
Additional keys: see wildcard field
links.*stringAdditional keys
numErrorsJSONOptional
numErrors (anyOf 1)integerAlternativeThe total number of errors encountered during the batch operation.
Format: int32
numErrors (anyOf 2)stringAlternativePattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
requestedAtstringOptionalThe date and time when the batch operation was requested, in ISO 8601 format.
Format: date-time
resultsarrayRequired within parentAn array of SimplePublicUpsertObject items representing the results of the batch upsert operation.
results[]ModelEach itemExpand Upsert batch objects — fees.batchUpsertFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item
startedAtstringRequired within parentThe date and time when the batch operation started, in ISO 8601 format.
Format: date-time
statusstringRequired within parentThe current status of the batch operation. Valid values include 'PENDING', 'PROCESSING', 'CANCELED', and 'COMPLETE'.
Known values: CANCELED, COMPLETE, PENDING, PROCESSING

Referenced models: Read batch objects — fees.batchGetFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING errors item, Upsert batch objects — fees.batchUpsertFees — response body — status: CANCELED, COMPLETE, PENDING, PROCESSING results item

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.