List and Get Offers

Retrieve a list of your offers or get details of a specific offer.

List Offers

Get a paginated list of all your offers with optional filtering.

Endpoint

GET /v1/offers

Query Parameters

Parameter	Type	Required	Description
pagination[page]	integer	No	Page number (default: 1)
pagination[per_page]	integer	No	Items per page
filters[status]	string	No	Filter by status: active, draft, deleted
filters[offer_type]	string	No	Filter by type: accounts, items, currency
filters[game_id]	string	No	Filter by game ID

Request Example

curl -X GET "https://sellerapi.ggchest.com/v1/offers?pagination[page]=1&pagination[per_page]=20&filters[status]=active&filters[offer_type]=accounts" \
  -H "X-API-KEY: your-api-key-here"

Response Example

{
  "items": [
    {
      "id": "cc0e8400-e29b-41d4-a716-446655440030",
      "offer_type": "accounts",
      "title": "World of Warcraft Level 60 Account",
      "description": "Premium account with rare mounts and achievements",
      "price": "99.99",
      "old_price": "149.99",
      "status": "active",
      "delivery_method": "manual",
      "delivery_time": "5m",
      "qty_total": "10",
      "qty_min": "1",
      "page_slug": "world-of-warcraft-level-60-account",
      "icon": {
        "id": "dd0e8400-e29b-41d4-a716-446655440031",
        "path": "https://cdn.ggchest.com/offers/icon.png"
      },
      "game_id": "550e8400-e29b-41d4-a716-446655440000",
      "game_name": "World of Warcraft",
      "attributes": [
        {
          "attribute_id": "aa0e8400-e29b-41d4-a716-446655440020",
          "attribute_name": "Server",
          "option_id": "bb0e8400-e29b-41d4-a716-446655440021",
          "option_name": "US-East"
        },
        {
          "attribute_id": "aa0e8400-e29b-41d4-a716-446655440024",
          "attribute_name": "Level",
          "option_id": "bb0e8400-e29b-41d4-a716-446655440025",
          "option_name": "1-10"
        }
      ],
      "expired_at": "2024-12-31T23:59:59Z",
      "extra_properties": {
        "game_currency": null
      }
    },
    {
      "id": "cc0e8400-e29b-41d4-a716-446655440032",
      "offer_type": "currency",
      "title": "100,000 Gold",
      "description": "Fast delivery, secure transaction",
      "price": "29.99",
      "status": "active",
      "delivery_method": "manual",
      "delivery_time": "5m",
      "qty_total": "1000",
      "qty_min": "100",
      "page_slug": "100000-gold",
      "icon": null,
      "game_id": "550e8400-e29b-41d4-a716-446655440000",
      "game_name": "World of Warcraft",
      "attributes": [],
      "expired_at": null,
      "extra_properties": {
        "game_currency": {
          "id": "880e8400-e29b-41d4-a716-446655440010",
          "name": "Gold",
          "nominal": "1000",
          "icon": {
            "id": "990e8400-e29b-41d4-a716-446655440011",
            "path": "https://cdn.ggchest.com/icons/gold.png"
          }
        }
      }
    }
  ],
  "pagination": {
    "total_count": 45,
    "page_count": 3,
    "page": 1,
    "per_page": 20
  }
}

Response Fields

Field	Type	Description
items	array	Array of offer objects
items[].id	string	Offer identifier (UUID)
items[].offer_type	string	Offer type: accounts, items, currency
items[].title	string	Offer title
items[].description	string	Offer description
items[].price	string	Price in USD
items[].old_price	string|null	Previous price (for showing discounts)
items[].status	string	Status: active, draft, deleted
items[].delivery_method	string	Delivery method: manual, auto
items[].delivery_time	string	Estimated delivery time. Values: 5m, 20m, 1h, 5h, 12h, 1d, 2d, 3d, 7d, 14d, 28d
items[].qty_total	string	Total quantity available
items[].qty_min	string	Minimum purchase quantity
items[].page_slug	string|null	URL slug for the offer page
items[].icon	object|null	Offer icon
items[].icon.id	string	Icon identifier
items[].icon.path	string	URL to icon image
items[].game_id	string	Game identifier
items[].game_name	string	Game name
items[].attributes	array	Offer attributes
items[].attributes[].attribute_id	string	Attribute identifier
items[].attributes[].attribute_name	string	Attribute name
items[].attributes[].option_id	string	Selected option identifier
items[].attributes[].option_name	string	Selected option name
items[].expired_at	string|null	Expiration date (ISO 8601)
items[].extra_properties	object	Additional properties based on offer type
items[].extra_properties.game_currency	object|null	Currency details (for currency offers)
pagination	object	Pagination information
pagination.total_count	integer	Total number of offers
pagination.page_count	integer	Total number of pages
pagination.page	integer	Current page number
pagination.per_page	integer	Items per page

Get Single Offer

Retrieve detailed information about a specific offer.

Endpoint

GET /v1/offers/{id}

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Offer ID (UUID)

Request Example

curl -X GET "https://sellerapi.ggchest.com/v1/offers/cc0e8400-e29b-41d4-a716-446655440030" \
  -H "X-API-KEY: your-api-key-here"

Response Example

{
  "id": "cc0e8400-e29b-41d4-a716-446655440030",
  "title": "World of Warcraft Level 60 Account",
  "offer_type": "accounts",
  "description": "Premium account with rare mounts and achievements",
  "price": "99.99",
  "status": "active",
  "delivery_time": "5m",
  "delivery_method": "manual",
  "qty_total": 10,
  "qty_min": 1,
  "game_id": "550e8400-e29b-41d4-a716-446655440000",
  "icon": {
    "id": "dd0e8400-e29b-41d4-a716-446655440031",
    "path": "https://cdn.ggchest.com/offers/icon.png"
  },
  "attributes": [
    {
      "id": "aa0e8400-e29b-41d4-a716-446655440020",
      "attribute_name": "Server",
      "option_id": "bb0e8400-e29b-41d4-a716-446655440021",
      "option_name": "US-East"
    }
  ],
  "extra_properties": {
    "accounts": [
      {
        "id": "ee0e8400-e29b-41d4-a716-446655440040",
        "description": "Account #1",
        "login": "player123",
        "password": "securepass",
        "email_login": "[email protected]",
        "email_password": "emailpass"
      }
    ],
    "game_currency": null
  }
}

Response Fields

Field	Type	Description
id	string	Offer identifier (UUID)
title	string	Offer title
offer_type	string	Offer type: accounts, items, currency
description	string	Offer description
price	string	Price in USD
old_price	string|null	Previous price (for showing discounts)
status	string	Status: active, draft, deleted
delivery_time	string	Estimated delivery time. Values: 5m, 20m, 1h, 5h, 12h, 1d, 2d, 3d, 7d, 14d, 28d
delivery_method	string	Delivery method: manual, auto
qty_total	integer	Total quantity available
qty_min	integer	Minimum purchase quantity
game_id	string	Game identifier
icon	object|null	Offer icon
attributes	array	Offer attributes
extra_properties	object	Additional properties based on offer type
extra_properties.accounts	array|null	Account details (for account offers)
extra_properties.accounts[].id	string	Account identifier
extra_properties.accounts[].login	string|null	Account login
extra_properties.accounts[].password	string|null	Account password
extra_properties.accounts[].email_login	string|null	Email login
extra_properties.accounts[].email_password	string|null	Email password
extra_properties.accounts[].description	string|null	Account description
extra_properties.game_currency	object|null	Currency details (for currency offers)

Error Responses

404 Not Found

Returned when the offer ID is invalid or the offer doesn't exist.

{
  "message": "Page not found"
}