Skip to main content

GET /api/v1/p2p/orders/{id}

Retrieve detailed information about a specific P2P order, including payment details and counterparty info. Only the buyer or seller of the order can access this endpoint.

Authentication​

Required. Pass a Bearer token in the Authorization header. The authenticated user must be a party to the order.

Request​

ParameterTypeInDescription
idintegerpathThe order ID

Example​

curl https://example.com/api/v1/p2p/orders/101 \
-H "Authorization: Bearer <token>"

Response​

200 OK​

Returns a P2POrder object with payment details and counterparty information.

{
"id": 101,
"ad_id": 42,
"buyer_id": 15,
"seller_id": 7,
"usdt_amount": 500000,
"fiat_amount": 500000,
"fiat_currency": "RUB",
"exchange_rate": 100,
"payment_method": "sber",
"payment_details": {
"sber": "4276 **** **** 1234"
},
"status": "pending",
"frozen_balance": 500000,
"operator_called": false,
"created_at": "2026-04-04T12:05:00Z",
"updated_at": "2026-04-04T12:05:00Z",
"counterpart": {
"id": 7,
"name": "trader42",
"nickname": "trader42",
"avatar_url": "https://cdn.example.com/avatars/7.png"
}
}

Errors​

StatusCodeDescription
401UNAUTHORIZEDMissing or invalid token
403FORBIDDENAuthenticated user is not a party to this order
404NOT_FOUNDOrder with the given ID does not exist