It is best practice to only send data that you want updated as it will return a much faster response. For instance, if you only need to update the Transaction.CloseDate value, then you should set all other Transaction properties to null so that only a close date update is attempted.
Unless the primary office allows manual entry for a transaction number and you actually want to change the transaction number, it is best to always set the Transaction.Number property to NULL before sending the request. This will guarantee that the transaction number is not updated.
The status of a transaction cannot be updated using this resource. The status is a read only property. You must use the finalize resource to change the status.
Please see the Creating and Updating Data section of the introduction for more information on how to set property values.
The response will contain the updated transaction object populated with all of the data to which you have read access regardless of the properties sent in the request. For instance, if you sent a Transaction object with the Conditions property set to null but the transaction contained 2 conditions, the Transaction.Conditions property of the response will contain those 2 conditions. You can use the OData $expand parameter to limit the data that is returned.
The value for the Transaction.Id property in the Transaction object sent in the request is ignored.
OData Support: $expand
Path parameters
-
The Lone Wolf Id of the transaction. This will be the value in the Transaction.Id property when the transaction was created.
Query parameters
-
Instructs the API to include a child object or collection in the response. If omitted, ALL child objects and collections are returned. Pass
$expand=(empty) to return only the root object. See the OData Support section of the introduction.
Body
Required
A Transaction object.
-
The Lone Wolf Id of the transaction. Required for updates only. It will be ignored when creating a new transaction.
Maximum length is
50. -
The transaction number. In most cases, the transaction number will be automatically generated. This is only required if the primary office for the trade allows manual transaction number entry and it has not setup a sequence for transaction numbers.
Maximum length is
15. -
The MLS number for the listing associated to the transaction.
Maximum length is
15. -
The Lone Wolf Id of the property type. This is an Id that is retrieved from the property types resource.
Maximum length is
50. -
The Lone Wolf Id of the classification. This is an Id that is retrieved from the classifications resource.
Maximum length is
50. -
The date the transaction was entered. This is not the date that the transaction record was created (though in most cases, it will be the same value). This is a client specified date. If not specified, then the current date is used.
-
The date the transaction closed.
-
The date an offer was made on the transaction.
-
The final sale price.
-
Any legal notices for the transaction.
Maximum length is
100. -
The MLS style address for the transaction. The $expand OData parameter will have no effect on this property; it will always be returned with the transaction data.
-
The list of different tiers for the transactions. At least 1 is required.
-
The list of client contacts for the transaction.
-
The list of business contacts for the transaction.
-
The list of conditions for the transaction.
-
The version of the record in the database.
Responses
-
A Transaction object holding all the updated data.
-
Error Code 1006: Validation failed. See the Details property of the response for information on why the validation failed. Error Code 1008: Invalid operation. This occurs when attempting to update or create an object without the required permission. For instance, if you don't have create permission for Conditions but you pass through a list of Conditions in the Transaction.Conditions property or if you attempt to update the Transaction.CloseDate but do not have edit permissions for that field. See the Details property of the response for more information.
-
Either the transaction or a child object was not found. For instance, if you attempt to set the classification of a transaction with a ClassificationId that does not exist. The primary office for the transaction must be an office with the Client Code used in the API authentication.
curl \
--request PUT 'https://api.globalwolfweb.com/wolfconnect/transactions/v1/{transactionId}' \
--header "Authorization: $API_KEY" \
--header "Content-Type: application/json" \
--data '{"Id":"string","Number":"string","MLSNumber":"string","PropertyTypeId":"string","ClassificationId":"string","EntryDate":"2026-05-04","CloseDate":"2026-05-04","OfferDate":"2026-05-04","SellPrice":42.0,"LegalDescription":"string","MLSAddress":{"StreetNumber":"string","StreetName":"string","StreetDirection":"string","Unit":"string","City":"string","ProvinceCode":"string","PostalCode":"string","CountryCode":"string"},"Tiers":[{"Id":"string","Name":"string","ClassificationId":"string","SellPrice":42.0,"CloseDate":"2026-05-04","AgentCommissions":[{"Id":"string","AgentId":"string","TeamLeaderId":"string","EndCode":"string","EndCount":42.0,"Commission":42.0,"RowVersion":42}],"ExternalAgentCommissions":[{"Id":"string","ExternalAgentId":"string","EndCode":"string","Commission":42.0,"ExternalAgent":{"Id":"string","CRMId":"string","CRMCompanyContactId":"string","FirstName":"string","MiddleName":"string","LastName":"string","ContactTypeId":"string","EndCode":"string","CompanyName":"string","Addresses":[{"City":"string","Confidential":true,"CountryCode":"string","Line1":"string","Line2":"string","Line3":"string","Line4":"string","PostalCode":"string","ProvinceCode":"string","TypeCode":"string"}],"PhoneNumbers":[{"Confidential":true,"Extension":"string","Number":"string","Primary":true,"TypeCode":"string"}],"EmailAddresses":[{"Address":"string","Confidential":true,"Primary":true,"TypeCode":"string"}],"RowVersion":42,"AddressTypeCode":"string"},"RowVersion":42}],"RowVersion":42}],"ClientContacts":[{"Id":"string","CRMId":"string","FirstName":"string","MiddleName":"string","LastName":"string","ContactTypeId":"string","Title":"string","Prefix":"string","Suffix":"string","CompanyName":"string","MarketingName":"string","NickName":"string","LegalName":"string","FormerName":"string","GenderCode":"string","SourceOfBusinessId":"string","Addresses":[{"City":"string","Confidential":true,"CountryCode":"string","Line1":"string","Line2":"string","Line3":"string","Line4":"string","PostalCode":"string","ProvinceCode":"string","TypeCode":"string"}],"PhoneNumbers":[{"Confidential":true,"Extension":"string","Number":"string","Primary":true,"TypeCode":"string"}],"EmailAddresses":[{"Address":"string","Confidential":true,"Primary":true,"TypeCode":"string"}],"RowVersion":42,"SendMovingWolfEmails":true}],"BusinessContacts":[{"Id":"string","CRMId":"string","CRMCompanyContactId":"string","FirstName":"string","MiddleName":"string","LastName":"string","ContactTypeId":"string","EndCode":"string","CompanyName":"string","Addresses":[{"City":"string","Confidential":true,"CountryCode":"string","Line1":"string","Line2":"string","Line3":"string","Line4":"string","PostalCode":"string","ProvinceCode":"string","TypeCode":"string"}],"PhoneNumbers":[{"Confidential":true,"Extension":"string","Number":"string","Primary":true,"TypeCode":"string"}],"EmailAddresses":[{"Address":"string","Confidential":true,"Primary":true,"TypeCode":"string"}],"RowVersion":42}],"Conditions":[{"Id":"string","Description":"string","DueDate":"2026-05-04","ApprovedDate":"2026-05-04","RowVersion":42}],"RowVersion":42}'
{
"Id": "string",
"Number": "string",
"MLSNumber": "string",
"PropertyTypeId": "string",
"ClassificationId": "string",
"EntryDate": "2026-05-04",
"CloseDate": "2026-05-04",
"OfferDate": "2026-05-04",
"SellPrice": 42.0,
"LegalDescription": "string",
"MLSAddress": {
"StreetNumber": "string",
"StreetName": "string",
"StreetDirection": "string",
"Unit": "string",
"City": "string",
"ProvinceCode": "string",
"PostalCode": "string",
"CountryCode": "string"
},
"Tiers": [
{
"Id": "string",
"Name": "string",
"ClassificationId": "string",
"SellPrice": 42.0,
"CloseDate": "2026-05-04",
"AgentCommissions": [
{
"Id": "string",
"AgentId": "string",
"TeamLeaderId": "string",
"EndCode": "string",
"EndCount": 42.0,
"Commission": 42.0,
"RowVersion": 42
}
],
"ExternalAgentCommissions": [
{
"Id": "string",
"ExternalAgentId": "string",
"EndCode": "string",
"Commission": 42.0,
"ExternalAgent": {
"Id": "string",
"CRMId": "string",
"CRMCompanyContactId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string",
"ContactTypeId": "string",
"EndCode": "string",
"CompanyName": "string",
"Addresses": [
{
"City": "string",
"Confidential": true,
"CountryCode": "string",
"Line1": "string",
"Line2": "string",
"Line3": "string",
"Line4": "string",
"PostalCode": "string",
"ProvinceCode": "string",
"TypeCode": "string"
}
],
"PhoneNumbers": [
{
"Confidential": true,
"Extension": "string",
"Number": "string",
"Primary": true,
"TypeCode": "string"
}
],
"EmailAddresses": [
{
"Address": "string",
"Confidential": true,
"Primary": true,
"TypeCode": "string"
}
],
"RowVersion": 42,
"AddressTypeCode": "string"
},
"RowVersion": 42
}
],
"RowVersion": 42
}
],
"ClientContacts": [
{
"Id": "string",
"CRMId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string",
"ContactTypeId": "string",
"Title": "string",
"Prefix": "string",
"Suffix": "string",
"CompanyName": "string",
"MarketingName": "string",
"NickName": "string",
"LegalName": "string",
"FormerName": "string",
"GenderCode": "string",
"SourceOfBusinessId": "string",
"Addresses": [
{
"City": "string",
"Confidential": true,
"CountryCode": "string",
"Line1": "string",
"Line2": "string",
"Line3": "string",
"Line4": "string",
"PostalCode": "string",
"ProvinceCode": "string",
"TypeCode": "string"
}
],
"PhoneNumbers": [
{
"Confidential": true,
"Extension": "string",
"Number": "string",
"Primary": true,
"TypeCode": "string"
}
],
"EmailAddresses": [
{
"Address": "string",
"Confidential": true,
"Primary": true,
"TypeCode": "string"
}
],
"RowVersion": 42,
"SendMovingWolfEmails": true
}
],
"BusinessContacts": [
{
"Id": "string",
"CRMId": "string",
"CRMCompanyContactId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string",
"ContactTypeId": "string",
"EndCode": "string",
"CompanyName": "string",
"Addresses": [
{
"City": "string",
"Confidential": true,
"CountryCode": "string",
"Line1": "string",
"Line2": "string",
"Line3": "string",
"Line4": "string",
"PostalCode": "string",
"ProvinceCode": "string",
"TypeCode": "string"
}
],
"PhoneNumbers": [
{
"Confidential": true,
"Extension": "string",
"Number": "string",
"Primary": true,
"TypeCode": "string"
}
],
"EmailAddresses": [
{
"Address": "string",
"Confidential": true,
"Primary": true,
"TypeCode": "string"
}
],
"RowVersion": 42
}
],
"Conditions": [
{
"Id": "string",
"Description": "string",
"DueDate": "2026-05-04",
"ApprovedDate": "2026-05-04",
"RowVersion": 42
}
],
"RowVersion": 42
}
{
"Id": "string",
"Number": "string",
"MLSNumber": "string",
"PropertyTypeId": "string",
"PropertyType": {
"Id": "string",
"LWCompanyCode": "string",
"Code": "string",
"Name": "string",
"Default": true,
"ClassCode": "string",
"Class": "string",
"InactiveDate": "2026-05-04"
},
"ClassificationId": "string",
"Classification": {
"Id": "string",
"LWCompanyCode": "string",
"Code": "string",
"Name": "string",
"EndCount": 42.0,
"InactiveDate": "2026-05-04"
},
"StatusCode": "string",
"Status": "string",
"EntryDate": "2026-05-04",
"CloseDate": "2026-05-04",
"OfferDate": "2026-05-04",
"SellPrice": 42.0,
"LegalDescription": "string",
"MLSAddress": {
"StreetNumber": "string",
"StreetName": "string",
"StreetDirection": "string",
"Unit": "string",
"City": "string",
"ProvinceCode": "string",
"Province": "string",
"PostalCode": "string",
"CountryCode": "string",
"Country": "string"
},
"Tiers": [
{
"Id": "string",
"Name": "string",
"ClassificationId": "string",
"Classification": {
"Id": "string",
"LWCompanyCode": "string",
"Code": "string",
"Name": "string",
"EndCount": 42.0,
"InactiveDate": "2026-05-04"
},
"StatusCode": "string",
"Status": "string",
"SellPrice": 42.0,
"CloseDate": "2026-05-04",
"SellingCommission": 42.0,
"BuyingCommission": 42.0,
"TotalCommission": 42.0,
"AgentCommissions": [
{
"Id": "string",
"AgentId": "string",
"TeamLeaderId": "string",
"EndCode": "string",
"End": "string",
"EndCount": 42.0,
"CommissionPercentage": 42.0,
"Commission": 42.0,
"Agent": {
"Id": "string",
"OfficeId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string"
},
"TeamLeader": {
"Id": "string",
"OfficeId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string"
},
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42
}
],
"ExternalAgentCommissions": [
{
"Id": "string",
"ExternalAgentId": "string",
"EndCode": "string",
"End": "string",
"Commission": 42.0,
"ExternalAgent": {
"Id": "string",
"CRMId": "string",
"CRMCompanyContactId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string",
"ContactTypeId": "string",
"ContactType": {
"Id": "string",
"LWCompanyCode": "string",
"Code": "string",
"Name": "string",
"CategoryCode": "string",
"InactiveDate": "2026-05-04"
},
"EndCode": "string",
"End": "string",
"CompanyName": "string",
"Addresses": [
{
"City": "string",
"Confidential": true,
"Country": "string",
"CountryCode": "string",
"Line1": "string",
"Line2": "string",
"Line3": "string",
"Line4": "string",
"PostalCode": "string",
"Province": "string",
"ProvinceCode": "string",
"Type": "string",
"TypeCode": "string"
}
],
"PhoneNumbers": [
{
"Confidential": true,
"Extension": "string",
"Number": "string",
"Primary": true,
"Type": "string",
"TypeCode": "string"
}
],
"EmailAddresses": [
{
"Address": "string",
"Confidential": true,
"Primary": true,
"Type": "string",
"TypeCode": "string"
}
],
"RowVersion": 42,
"AddressTypeCode": "string"
},
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42
}
],
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42
}
],
"ClientContacts": [
{
"Id": "string",
"CRMId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string",
"ContactTypeId": "string",
"ContactType": {
"Id": "string",
"LWCompanyCode": "string",
"Code": "string",
"Name": "string",
"CategoryCode": "string",
"InactiveDate": "2026-05-04"
},
"Title": "string",
"Prefix": "string",
"Suffix": "string",
"CompanyName": "string",
"MarketingName": "string",
"NickName": "string",
"LegalName": "string",
"FormerName": "string",
"GenderCode": "string",
"Gender": "string",
"SourceOfBusinessId": "string",
"SourceOfBusiness": {
"Id": "string",
"LWCompanyCode": "string",
"Code": "string",
"Name": "string",
"InactiveDate": "2026-05-04"
},
"Addresses": [
{
"City": "string",
"Confidential": true,
"Country": "string",
"CountryCode": "string",
"Line1": "string",
"Line2": "string",
"Line3": "string",
"Line4": "string",
"PostalCode": "string",
"Province": "string",
"ProvinceCode": "string",
"Type": "string",
"TypeCode": "string"
}
],
"PhoneNumbers": [
{
"Confidential": true,
"Extension": "string",
"Number": "string",
"Primary": true,
"Type": "string",
"TypeCode": "string"
}
],
"EmailAddresses": [
{
"Address": "string",
"Confidential": true,
"Primary": true,
"Type": "string",
"TypeCode": "string"
}
],
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42,
"SendMovingWolfEmails": true,
"ShouldReceiveMovingWolfEmails": true,
"MovingWolfEmailsSendingAgentId": 42
}
],
"BusinessContacts": [
{
"Id": "string",
"CRMId": "string",
"CRMCompanyContactId": "string",
"FirstName": "string",
"MiddleName": "string",
"LastName": "string",
"ContactTypeId": "string",
"ContactType": {
"Id": "string",
"LWCompanyCode": "string",
"Code": "string",
"Name": "string",
"CategoryCode": "string",
"InactiveDate": "2026-05-04"
},
"EndCode": "string",
"End": "string",
"CompanyName": "string",
"Addresses": [
{
"City": "string",
"Confidential": true,
"Country": "string",
"CountryCode": "string",
"Line1": "string",
"Line2": "string",
"Line3": "string",
"Line4": "string",
"PostalCode": "string",
"Province": "string",
"ProvinceCode": "string",
"Type": "string",
"TypeCode": "string"
}
],
"PhoneNumbers": [
{
"Confidential": true,
"Extension": "string",
"Number": "string",
"Primary": true,
"Type": "string",
"TypeCode": "string"
}
],
"EmailAddresses": [
{
"Address": "string",
"Confidential": true,
"Primary": true,
"Type": "string",
"TypeCode": "string"
}
],
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42
}
],
"Conditions": [
{
"Id": "string",
"Description": "string",
"DueDate": "2026-05-04",
"ApprovedDate": "2026-05-04",
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42
}
],
"Task": [
{
"Id": "string",
"LoadingDocsTaskId": "string",
"Title": "string",
"DueDate": "2026-05-04",
"Reminder": true,
"ReminderSentTimestamp": "2026-05-04T09:42:00Z",
"CompletedDate": "2026-05-04",
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42
}
],
"CreatedTimestamp": "2026-05-04T09:42:00Z",
"ModifiedTimestamp": "2026-05-04T09:42:00Z",
"TransactionChangedTimestamp": "2026-05-04T09:42:00Z",
"RowVersion": 42
}
{
"Code": 42,
"Message": "string",
"Details": "string"
}
{
"Code": 42,
"Message": "string",
"Details": "string"
}