Get a trade offer status

GET

/v1/offer-status/{Offer-ID}

The endpoint retrieves the current status of a specific trade offer, providing information on whether it is created, in progress, finished, or failed, thereby enabling users to monitor and manage their trading activities effectively.

In case of failure, it provides additional details about the error to help users and partners understand and address the issue.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Header Params

Responses

🟢200

application/json

Offer has been accepted

Bodyapplication/json

🟠401

🟠403

🟠404

🔴500

🔴503

🟠429429

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/offer-status/' \
--header 'bp-user-id;' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Example 1

{
    "data": {
        "status": "created",
        "errors": {
            "code": "422",
            "title": "user.transaction.trading.disabled"
        }
    }
}

Modified at 2026-04-17 02:40:57

Accept a trade offer V3

List all non-user initiated transactions per partner or per user