# Retrieve a Transaction

**GET /wolfconnect/transactions/v1/{transactionId}**

Retrieves a transaction. The data in the response will contain all of the data to which you have read access. Properties with values of NULL typically mean that you do not have read access to that property. Please see the Permissions section of the introduction for more information.

**OData Support:** $expand


## Servers
- Production: https://api.globalwolfweb.com (Production)
- Test: https://api-sb.globalwolfweb.com (Test)


## Authentication methods
- Lone wolf token


## Parameters

### Path parameters

- **transactionId** (string)
  The Lone Wolf Id of the transaction. This will be the value in the Transaction.Id property when the transaction was created.


### Query parameters

- **$expand** (string)
  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.



## Responses
### 200
A Transaction object.

#### Body: application/json (object)
- **Id** (string)
  The Lone Wolf Id of the transaction. Required for updates only. It will be ignored when creating a new transaction.

- **Number** (string)
  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.

- **MLSNumber** (string)
  The MLS number for the listing associated to the transaction.

- **PropertyTypeId** (string)
  The Lone Wolf Id of the property type. This is an Id that is retrieved from the property types resource.

- **PropertyType** (object)
  The property type. See the Property Types API section for the object definition.

- **ClassificationId** (string)
  The Lone Wolf Id of the classification. This is an Id that is retrieved from the classifications resource.

- **Classification** (object)
  The classification. See the Classifications API section for the object definition.

- **StatusCode** (string)
  The code for the status. N: Open, A: Closed, P: Partially closed (not all but at least one tier has been finalized), B: Fallen through because of a condition, C: Fallen through

- **Status** (string)
  The name of the status. This field is read only.

- **EntryDate** (string(date))
  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.

- **CloseDate** (string(date))
  The date the transaction closed.

- **OfferDate** (string(date))
  The date an offer was made on the transaction.

- **SellPrice** (number)
  The final sale price.

- **LegalDescription** (string)
  Any legal notices for the transaction.

- **MLSAddress** (object)
  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.

- **Tiers** (array[object])
  The list of different tiers for the transactions. At least 1 is required.

- **ClientContacts** (array[object])
  The list of client contacts for the transaction.

- **BusinessContacts** (array[object])
  The list of business contacts for the transaction.

- **Conditions** (array[object])
  The list of conditions for the transaction.

- **Task** (array[object])
  The list of tasks for the transaction.

- **CreatedTimestamp** (string(date-time))
  The date and time the transaction was created.

- **ModifiedTimestamp** (string(date-time))
  The date and time the transaction was last modified.

- **TransactionChangedTimestamp** (string(date-time))
  The date and time the transaction or any of its associated objects were last changed. For instance, if a commission was added to a tier, the TransactionChangedTimestamp would hold the time that the commission was added. Any change to any object associated to the transaction will update this field. It is very useful when querying for transactions that have been modified since a particular date and time.

- **RowVersion** (integer(int64))
  The version of the record in the database.


### 400
Error Code 1001: The transaction Id is invalid.

#### Body: application/json (object)
- **Code** (integer)
  The Lone Wolf Error Code. See the Error Codes section of the introduction.

- **Message** (string)
  The message that corresponds to the Code value.

- **Details** (string)
  The exact problem that occurred to give this error response.


### 404
The transaction could not be found. The primary office for the transaction must be an office with the Client Code used in the API authentication.

#### Body: application/json (object)
- **Code** (integer)
  The Lone Wolf Error Code. See the Error Codes section of the introduction.

- **Message** (string)
  The message that corresponds to the Code value.

- **Details** (string)
  The exact problem that occurred to give this error response.



[Powered by Bump.sh](https://bump.sh)