On October 5, we are launching Buyer Records in reZEN—a new home for managing pre-contract buyer information and documents. This launch will change how buy-side transactions are created through the API. If you use API for transaction management, follow the instructions below to update your workflow.
What's changing
Every transaction must begin as a Listing, Buyer Record, or both for dual representation. Beginning Oct. 5, buy-side transactions can no longer be created directly through:
POST api/v1/transaction-builder
Listing creation is not changing.
What you need to do
If your integration uses this endpoint to create buy-side transactions, you will need to update it to the Buyer Record workflow by Oct. 5.:
- Create a Buyer Record
- Add the participants and details
- Convert the Buyer Record into a Transaction Builder
From there, the existing transaction workflow remains the same.
Key endpoints:
| Endpoint | Method | Usage |
|---|---|---|
| /api/v1/buyer-record | POST | Creates a new Buyer Record. This is the entry point. |
| /api/v1/buyer-record | GET | Searches Buyer Records with pagination, sorting, and filters. |
| /api/v1/buyer-record/{id} | GET / PATCH | Fetches or updates a Buyer Record. |
| /api/v1/buyer-record/{id}/participant | POST | Adds a participant. |
| /api/v1/buyer-record/{id}/participant/{participantId} | PATCH / DELETE | Updates or removes a participant. |
| /api/v1/buyer-record/{id}/build-transaction | POST | Converts the Buyer Record into a Transaction Builder. |
| /api/v1/buyer-record/{id}/request-termination | PATCH | Requests termination of the Buyer Record. |
| /api/v1/buyer-record/{id}/cancel-termination-request | PATCH | Cancels a pending termination request. |
| api/v1/transaction-builder/{id}/associations | PATCH | Changes the Buyer or Listing associated with a Transaction Builder. |
Full request and response schemas are available in Swagger under buyer-record-controller: View API documentation
Dual representation
Dual-representation transactions require both a Listing and a Buyer Record. Mark either record “In Contract” to create the Transaction Builder, then use the associations endpoint to link the other side.
Starting from a Listing:
- Create the Listing: POST api/v1/transaction-builder?type=LISTING
- Mark it “In Contract”: POST /api/v1/transaction-builder/{id}/transaction-to-builder
- Associate the Buyer Record: PATCH /api/v1/transaction-builder/{id}/associations
Starting from a Buyer Record:
- Create the Buyer Record: POST /api/v1/buyer-record
- Mark it “In Contract”: POST /api/v1/buyer-record/{id}/build-transaction
- Associate the Listing: PATCH /api/v1/transaction-builder/{id}/associations
Please complete any required integration updates by October 5.