> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gameboost.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List account offers

> Retrieve a paginated list of all account offers created by the authenticated seller with filtering and sorting options.



## OpenAPI

````yaml /api/openapi.json get /v2/account-offers
openapi: 3.1.0
info:
  title: GameBoost
  version: 2.0.0
servers:
  - url: https://api.gameboost.com
    description: GameBoost API
security:
  - BearerTokenSecurityScheme: []
tags:
  - name: Games
    description: Games
  - name: Seller Breaks
    description: Seller Breaks
  - name: Payments
    description: Payments
  - name: Payouts
    description: Payouts
  - name: Account Offers
    description: Account Offers
  - name: Account Orders
    description: Account Orders
  - name: Item Offers
    description: Item Offers
  - name: Item Orders
    description: Item Orders
  - name: Currency Offers
    description: Currency Offers
  - name: Currency Orders
    description: Currency Orders
  - name: Webhooks
    description: Webhook events sent to your endpoints when specific actions occur
  - name: Gift Card Offers
    description: Gift Card Offers
  - name: Gift Card Orders
    description: Gift Card Orders
paths:
  /v2/account-offers:
    get:
      tags:
        - Account Offers
      summary: List account offers
      description: >-
        Retrieve a paginated list of all account offers created by the
        authenticated seller with filtering and sorting options.
      parameters:
        - name: filter[search]
          in: query
          description: Search account offers by id, title, or description
          required: false
          schema:
            type: string
        - name: filter[id]
          in: query
          description: >-
            Filter by exact id. Supports comma-separated values for multiple
            matches.
          required: false
          schema:
            type: string
            example: 3,6,9
        - name: filter[external_id]
          in: query
          description: >-
            Filter by exact external id. Supports comma-separated values for
            multiple matches.
          required: false
          schema:
            type: string
            example: my-sku-123,my-sku-456
        - name: filter[title]
          in: query
          description: >-
            Filter by exact title. Supports comma-separated values for multiple
            matches.
          required: false
          schema:
            type: string
            example: example
        - name: filter[game_id]
          in: query
          description: >-
            Filter by exact game id. Supports comma-separated values for
            multiple matches.
          required: false
          schema:
            type: string
            example: 225477
        - name: filter[status]
          in: query
          description: Filter by status
          required: false
          schema:
            enum:
              - draft
              - pending
              - listed
              - processing
              - sold
              - refunded
              - archived
            type: string
            example: draft
        - name: filter[created_at]
          in: query
          description: >-
            Filter by created at. Supports single date (YYYY-MM-DD) or date
            range (YYYY-MM-DD,YYYY-MM-DD).
          required: false
          schema:
            type: string
            example: 2019-08-14,2025-12-31
        - name: filter[updated_at]
          in: query
          description: >-
            Filter by updated at. Supports single date (YYYY-MM-DD) or date
            range (YYYY-MM-DD,YYYY-MM-DD).
          required: false
          schema:
            type: string
            example: '2025-10-05'
        - name: filter[listed_at]
          in: query
          description: >-
            Filter by listed at. Supports single date (YYYY-MM-DD) or date range
            (YYYY-MM-DD,YYYY-MM-DD).
          required: false
          schema:
            type: string
            example: 2019-08-14,2025-12-31
        - name: sort
          in: query
          description: Sort by field. Prefix with - for descending order.
          required: false
          schema:
            enum:
              - id
              - '-id'
              - price
              - '-price'
              - views
              - '-views'
              - delivery_time
              - '-delivery_time'
              - created_at
              - '-created_at'
              - updated_at
              - '-updated_at'
              - listed_at
              - '-listed_at'
            default: '-updated_at'
            type: string
            example: '-updated_at'
        - name: per_page
          in: query
          description: Items per page (max 50)
          required: false
          schema:
            default: 15
            type: integer
            maximum: 50
            minimum: 1
      responses:
        '200':
          description: A paginated list of account offers
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/AccountOffer'
                  meta:
                    type: object
                    properties:
                      current_page:
                        type: integer
                      from:
                        type: integer
                      last_page:
                        type: integer
                      per_page:
                        type: integer
                      to:
                        type: integer
                      total:
                        type: integer
                  links:
                    type: object
                    properties:
                      first:
                        type: string
                        nullable: true
                      last:
                        type: string
                        nullable: true
                      prev:
                        type: string
                        nullable: true
                      next:
                        type: string
                        nullable: true
        '401':
          $ref: '#/components/responses/ErrorUnauthenticated'
        '429':
          $ref: '#/components/responses/ErrorRateLimited'
      security:
        - BearerToken: []
components:
  schemas:
    AccountOffer:
      description: Account offer object
      type: object
      properties:
        id:
          description: Unique identifier for the account offer
          type: integer
        external_id:
          description: >-
            External identifier for the account offer, used to map to your own
            system
          type: string
          nullable: true
        game:
          $ref: '#/components/schemas/GameRelation'
        account_order_ids:
          description: Account order IDs linked to this account
          type: array
          items:
            type: integer
          nullable: true
        title:
          description: Display name for the account offer
          type: string
        slug:
          description: URL-friendly identifier for the account offer
          type: string
        description:
          description: Detailed description of the account and its features
          type: string
          nullable: true
        parameters:
          description: >-
            Account-specific attributes such as level, rank, champions unlocked,
            etc.
          type: object
          nullable: true
        dump:
          description: >-
            Searchable metadata including keywords, tags, and categorization
            terms
          type: string
          nullable: true
        status:
          description: Current status of the account offer
          enum:
            - draft
            - pending
            - listed
            - processing
            - sold
            - refunded
            - archived
          type: string
        delivery_time:
          $ref: '#/components/schemas/DeliveryTime'
        is_manual_delivery:
          description: Indicates if the account requires manual delivery by seller
          type: boolean
        credentials:
          $ref: '#/components/schemas/AccountOfferCredential'
        delivery_instructions:
          description: >-
            Special instructions for account delivery, provided to buyer after
            purchase
          type: string
          nullable: true
        price:
          description: Account price in EUR currency
          type: string
        price_usd:
          description: Account price converted to USD using current exchange rates
          type: string
        views:
          description: Total number of times this account offer has been viewed
          type: integer
        image_urls:
          description: Array of image URLs showcasing the account
          type: array
          items:
            type: string
        created_at:
          description: Unix timestamp when the account offer was created
          type: integer
        updated_at:
          description: Unix timestamp of the last modification to the account offer
          type: integer
        listed_at:
          description: Unix timestamp when the account offer was made publicly available
          type: integer
          nullable: true
    GameRelation:
      description: Basic game information used in relations
      type: object
      properties:
        id:
          description: Unique identifier for the game
          type: integer
        name:
          description: Display name of the game
          type: string
        slug:
          description: URL-friendly identifier for the game
          type: string
    DeliveryTime:
      description: Delivery time object representing expected delivery duration
      type: object
      properties:
        duration:
          description: Numeric value representing the delivery time
          type: integer
        unit:
          description: Time unit for the duration (minutes, hours, days)
          enum:
            - minutes
            - hours
            - days
          type: string
        format:
          description: Human-readable delivery time (e.g., "2 hr")
          type: string
        format_long:
          description: Extended format delivery time (e.g., "2 hours")
          type: string
        seconds:
          description: Total delivery time converted to seconds
          type: integer
    AccountOfferCredential:
      description: Account credentials object containing login and email information
      type: object
      properties:
        login:
          description: Username or login identifier for the game account
          type: string
          nullable: true
        password:
          description: Password for the game account
          type: string
          nullable: true
        email_login:
          description: Email address used for account login
          type: string
          nullable: true
        email_password:
          description: Password for the associated email account
          type: string
          nullable: true
        email_provider:
          description: Email service provider domain (e.g., gmail.com, proton.me)
          type: string
          nullable: true
  responses:
    ErrorUnauthenticated:
      description: >-
        User is not authenticated, happens when the API key is missing, expired
        or invalid
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Unauthenticated.
    ErrorRateLimited:
      description: >-
        Rate limit exceeded, happens when you exceed the rate limit for the
        endpoint
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
                example: Too many requests.
  securitySchemes:
    BearerToken:
      type: http
      scheme: bearer
      bearerFormat: JWT

````