Sign in
Buy Orders V2

Changed on

Create a standing buy order

post/buy-orders/standing

Request

  • Base URL: /api/v2 (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v2/buy-orders/standing
  • Auth: verified (a scheme the document does not define)

Request body

game_item_idstring required
quantitynumber double required
price_per_unitnumber double required
quality_tier_minnumber double
quality_tier_maxnumber double
quality_value_minnumber double

Minimum quality value (0-1000) for resource buy orders

quality_value_maxnumber double

Maximum quality value (0-1000) for resource buy orders

negotiableboolean

Whether the buyer accepts counter-offers / offer sessions on this order

expires_in_daysnumber double
photo_resource_idsstring[]

Optional image resource IDs to attach to this buy order

visibility'public' | 'roster_only' | 'private'
target_supplier_idstring

Direct to a specific supplier user (requires visibility = 'private')

target_supplier_contractor_idstring

Direct to a specific supplier org (requires visibility = 'private')

Response

Ok

buy_order_idstring required
game_item_idstring required
game_item_namestring required
game_item_typestring

Game item type for quality mode determination

buyer_idstring required
buyer_namestring required
quantitynumber double required
quantity_fulfillednumber double required
price_per_unitnumber double required
quality_tier_minnumber double
quality_tier_maxnumber double
quality_value_minnumber double

Minimum quality value (0-1000)

quality_value_maxnumber double

Maximum quality value (0-1000)

negotiableboolean required
status'active' | 'fulfilled' | 'cancelled' | 'expired' required
created_atstring required
expires_atstring
visibility'public' | 'roster_only' | 'private'
target_supplier_idstring nullable
target_supplier_contractor_idstring nullable
declined_atstring nullable

Changes

  • 49be303fa4aaRevision changes
    • ○

      added the new optional request property

    • ○

      added the new optional request property

    • ○

      added the new optional request property

  • 6e90239467a7Revision changes
    • ○

      the endpoint scheme security verified was added to the API

    • ○

      the endpoint scheme security loggedin was removed from the API

    • ○

      added the new optional request property

    • ○

      added the optional property to the response with the status

    • ○

      added the required property to the response with the status