Skip to main content

User Bidding Report

Description​

The User Bidding Report call reports the bidding history of a specific user. The report is ordered from most recent bid to least recent bid. It can be filtered by category so that only bids on items in the requested category are returned.

The API must be structured correctly and have the correct security in place. See our document Troubleshooting.

See our documents Status Codes and Common Data for more information on results.

Making a request​

URL​

https://your_bidlogix_domain/auction-mgt/bdxapi/reporting/user/{userId}/{categoryId}/{pageSize}/{page}?clientId=your_bidlogix_client_id

HTTP Method​

GET

Headers​

KeyValue
BDXAPI_NAMEBidlogix API Signature
Content-Typeapplication/json

Path Parameters and Adaptations​

ParameterValue
userIdID of the user you wish to retrieve information for
categoryIdthe ID of the category you wish to retrieve information for. Set to -1 to retrieve all
pageSizerecords to return per page
pagethe page to start from
clientIdyour bidlogix Client ID

Also see API Introduction.

Examples​

Call

https://hove.eu-west-2.bidjs.com/auction-mgt/bdxapi/reporting/user/196/5523/200/0?clientId=302

Response

{
    "@class": ".DataPushPayload",
    "pushCode": "REPORTING_USER",
    "models": {
        "userReport": {
            "@class": ".reporting.UserReportModel",
            "reportMeta": {
                "@class": ".ReportMetaModel",
                "reportType": 2,
                "reportObject": "UserReportModel",
                "reportMade": 1634737032496
            },
            "reportTitle": "User Report",
            "userId": 196,
            "username": "bidder3_demo",
            "categoryId": 5523,
            "count": 1,
            "email": "test@bidlogixtest.com",
            "externalRef": "D232",
            "lastLogOn": "20-Oct-21 13:24:01",
            "items": [
                {
                    "@class": ".UserBiddingReportModel",
                    "auctionId": 3304,
                    "auctionTitle": "title4",
                    "catId": 5523,
                    "lotId": 364349,
                    "lotNumber": "1",
                    "itemTitle": "Black Mercedes Soft Top Sports Car",
                    "userAmount": 500,
                    "winningAmount": 6000100,
                    "placed": 1630491653000,
                    "curId": 2
                },
                {
                    "@class": ".UserBiddingReportModel",
                    "auctionId": 3304,
                    "auctionTitle": "title4",
                    "catId": 5523,
                    "lotId": 364349,
                    "lotNumber": "1",
                    "itemTitle": "Black Mercedes Soft Top Sports Car",
                    "userAmount": 300,
                    "winningAmount": 6000100,
                    "placed": 1630491555000,
                    "curId": 2
                },
                {
                    "@class": ".UserBiddingReportModel",
                    "auctionId": 3304,
                    "auctionTitle": "title4",
                    "catId": 5523,
                    "lotId": 364349,
                    "lotNumber": "1",
                    "itemTitle": "Black Mercedes Soft Top Sports Car",
                    "userAmount": 200,
                    "winningAmount": 6000100,
                    "placed": 1630491421000,
                    "curId": 2
                }
            ]
        }
    },
    "webAppContext": "302"
}

Errors​

codeexample
401 UNAUTHORIZED{ error : "Log in" }
422 Unprocessable Entry{ error : ["<field_name>"] }