Accept a swap offer

This endpoint enables the users to formally accept an existing swap offer. When sending a request, it must include the unique identifier of the swap offer the users wish to accept, thereby indicating their intention to proceed with the exchange under the conditions previously outlined. The endpoint is idempotent so in case of an unknown status code returned a retry to accept the swap should respond with the correct status.

SecuritybearerAuth
Request
path Parameters
Swap-Offer-Id
required
string <uuid>

A string parameter representing the unique identifier of the swap offer to be accepted. This ID should be included in the path of the request URL

query Parameters
external_swap_id
required
string [ 10 .. 100 ] characters

A string parameter representing an external swap ID associated with the offer. It should be included as a query parameter in the URL

header Parameters
bp-user-id
required
string <uuid>

A string parameter representing the User ID (uuid format).

Responses
200

Success Response (The swap trade has bee executed)

202

Accepted

401

Unauthorized

403

Forbidden

405

Not Allowed

409

Offer already accepted / A newer offer was created

410

Gone

422

Validation Error

429

Too Many Requests

500

Internal Error

503

Maintenance or Service unavailable

patch/v1/swaps/{Swap-Offer-Id}/accept
Request samples 
Response samples 
application/json
{
  • "data": {
    }
}