Manage offer (create or edit with automatic status determination)

curl --request POST \
  --url https://skycoach.gg/api/shop/marketplace/products/{productId}/offers/manage \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "offers": [
    {
      "price_per_step": 2,
      "amount": 1,
      "min_purchase_amount": "1",
      "data": {
        "69": [],
        "70": [],
        "71": "Grandmaster",
        "72": "Brazil",
        "73": 7005,
        "74": "Handmade",
        "78": 1,
        "204": 200
      },
      "marketplace_type": 2,
      "is_auto_activate_status": true,
      "outer_name": "LoL Account with Rare Skins",
      "internal_name": "LoL_Account_001",
      "description": "Account with Officer Vi and Pharaoh Amumu skins",
      "credential_system_type_id": 1,
      "search_description": "LoL account with rare skins"
    },
    {
      "id": 336372,
      "price_per_step": 2,
      "amount": 1,
      "min_purchase_amount": "1",
      "data": {
        "69": [],
        "70": [],
        "71": "Grandmaster",
        "72": "Brazil",
        "73": 7005,
        "74": "Handmade",
        "78": 1,
        "204": 200
      },
      "marketplace_type": 2,
      "is_auto_activate_status": true,
      "outer_name": "LoL Account with Rare Skins",
      "internal_name": "LoL_Account_001",
      "description": "Account with Officer Vi and Pharaoh Amumu skins",
      "credential_system_type_id": 1,
      "search_description": "LoL account with rare skins"
    }
  ],
  "guarantee_delivery_time": "1-2 hours"
}
'

{
  "result": {
    "message": "ok",
    "received": 3,
    "successfully": 2,
    "results": [
      {
        "id": 335838,
        "status": "ok",
        "message": "Failed to process offer"
      }
    ]
  }
}

Offers

Manage offer (create or edit with automatic status determination)

Create or edit offers with full field validation including custom data fields. Status is automatically determined based on validation results and account capabilities. Status field is prohibited in request - it will be set automatically. * Automatic status determination:

- Gold marketplace: Always set to Active if validation passes
- Account marketplace:
- If data field validation fails → Need Details
- If MULTIPLE credential system and no active credentials → Not Active
- If all validations pass → On Review (for moderation)

Operation type (add/edit):

- Operation type is determined automatically by presence of ‘id’ field in offer object
- If ‘id’ is present → edit operation (only provided fields will be updated)
- If ‘id’ is missing → add operation (all required fields must be provided)
Edit existing offers or create new ones. Each offer is validated and processed separately. Results are returned as an array with status for each offer.

POST

api

shop

marketplace

products

{productId}

offers

manage

Manage offer (create or edit with automatic status determination)

curl --request POST \
  --url https://skycoach.gg/api/shop/marketplace/products/{productId}/offers/manage \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "offers": [
    {
      "price_per_step": 2,
      "amount": 1,
      "min_purchase_amount": "1",
      "data": {
        "69": [],
        "70": [],
        "71": "Grandmaster",
        "72": "Brazil",
        "73": 7005,
        "74": "Handmade",
        "78": 1,
        "204": 200
      },
      "marketplace_type": 2,
      "is_auto_activate_status": true,
      "outer_name": "LoL Account with Rare Skins",
      "internal_name": "LoL_Account_001",
      "description": "Account with Officer Vi and Pharaoh Amumu skins",
      "credential_system_type_id": 1,
      "search_description": "LoL account with rare skins"
    },
    {
      "id": 336372,
      "price_per_step": 2,
      "amount": 1,
      "min_purchase_amount": "1",
      "data": {
        "69": [],
        "70": [],
        "71": "Grandmaster",
        "72": "Brazil",
        "73": 7005,
        "74": "Handmade",
        "78": 1,
        "204": 200
      },
      "marketplace_type": 2,
      "is_auto_activate_status": true,
      "outer_name": "LoL Account with Rare Skins",
      "internal_name": "LoL_Account_001",
      "description": "Account with Officer Vi and Pharaoh Amumu skins",
      "credential_system_type_id": 1,
      "search_description": "LoL account with rare skins"
    }
  ],
  "guarantee_delivery_time": "1-2 hours"
}
'

{
  "result": {
    "message": "ok",
    "received": 3,
    "successfully": 2,
    "results": [
      {
        "id": 335838,
        "status": "ok",
        "message": "Failed to process offer"
      }
    ]
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

enum<string>

default:application/json

required

API response format

Available options:

application/json

Path Parameters

productId

integer

required

Product currency marketplace ID

Example:

13

Body

application/json

offers

object[]

required

Array of offers to create or update. If an offer object contains 'id', it will be updated. If 'id' is missing, a new offer will be created.

Show child attributes

guarantee_delivery_time

integer

required

Guaranteed delivery time in milliseconds (e.g., 86400000 for 24 hours)

Required range: x >= 1

Example:

86400000

Response

Success

result

object

Show child attributes

Delete offer Edit offer status