Offer Attributes

Offer attributes define the characteristics and properties that can be assigned to offers for a specific game and offer type. Each attribute has multiple options that sellers can select when creating offers.

Get Offer Attributes

Retrieve all available attributes and their options for a specific game and offer type.

Endpoint

GET /v1/games/{id}/{offerType}/attributes

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Game ID (UUID)
offerType	string	Yes	Offer type. Values: accounts, items, currency

Request Example

curl -X GET "https://sellerapi.ggchest.com/v1/games/550e8400-e29b-41d4-a716-446655440000/accounts/attributes" \
  -H "X-API-KEY: your-api-key-here"

Response Example

[
  {
    "id": "aa0e8400-e29b-41d4-a716-446655440020",
    "attribute_name": "Server",
    "attribute_type": "dropdown",
    "options": [
      {
        "id": "bb0e8400-e29b-41d4-a716-446655440021",
        "name": "US-East"
      },
      {
        "id": "bb0e8400-e29b-41d4-a716-446655440022",
        "name": "US-West"
      },
      {
        "id": "bb0e8400-e29b-41d4-a716-446655440023",
        "name": "EU"
      }
    ]
  },
  {
    "id": "aa0e8400-e29b-41d4-a716-446655440024",
    "attribute_name": "Level",
    "attribute_type": "multiselect",
    "options": [
      {
        "id": "bb0e8400-e29b-41d4-a716-446655440025",
        "name": "1-10"
      },
      {
        "id": "bb0e8400-e29b-41d4-a716-446655440026",
        "name": "11-20"
      },
      {
        "id": "bb0e8400-e29b-41d4-a716-446655440027",
        "name": "21-30"
      }
    ]
  }
]

Response Fields

Field	Type	Required	Description
id	string	Yes	Attribute identifier (UUID)
attribute_name	string	Yes	Name of the attribute
attribute_type	string	Yes	Attribute input type. Values: dropdown, advanced_card, simple_card_with_icon, simple_card_without_icon, multiselect
options	array	Yes	List of available options for this attribute
options[].id	string	Yes	Option identifier (UUID)
options[].name	string	Yes	Option name/value

Usage in Offers

When creating or updating an offer, you must include attributes in the request body. Each attribute should specify:

• id: The attribute ID
• option_id: The selected option ID for that attribute

Example:

{
  "attributes": [
    {
      "id": "aa0e8400-e29b-41d4-a716-446655440020",
      "option_id": "bb0e8400-e29b-41d4-a716-446655440021"
    },
    {
      "id": "aa0e8400-e29b-41d4-a716-446655440024",
      "option_id": "bb0e8400-e29b-41d4-a716-446655440025"
    }
  ]
}

Error Responses

404 Not Found

Returned when the game ID is invalid or the game doesn't support the specified offer type.

{
  "message": "Page not found"
}