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

# Get pre-3.0 order status (by ID)

> Only orders and groups placed before release 3.0 (no status key) — public by identifier (ID or number). New ones: `GET /orders/by-number/{orderNumber}/status?key=`; here they return 404.



## OpenAPI

````yaml /openapi.en.json get /api/v2/storefront/v1/orders/{orderId}/status
openapi: 3.0.0
info:
  title: ItemShop v2 API
  description: >-
    REST API platformy ItemShop v2 (NestJS + Fastify). Wszystkie ścieżki mają
    prefiks /api/v2.
  version: 2.0.0
  contact: {}
servers:
  - url: https://itemshop.dev
    description: Production (API under /api/v2, same origin as the panel)
  - url: http://localhost:3000
    description: Local
security: []
tags: []
paths:
  /api/v2/storefront/v1/orders/{orderId}/status:
    get:
      tags:
        - Storefront v1
      summary: Get pre-3.0 order status (by ID)
      description: >-
        Only orders and groups placed before release 3.0 (no status key) —
        public by identifier (ID or number). New ones: `GET
        /orders/by-number/{orderNumber}/status?key=`; here they return 404.
      operationId: getOrderStatus
      parameters:
        - name: orderId
          required: true
          in: path
          description: Order or payment group ID or number
          schema:
            type: string
            example: 664f1a2b3c4d5e6f7a8b9c0d
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StorefrontOrderStatusResponseDto'
        '403':
          description: Origin outside the shop domains (`ORIGIN_NOT_ALLOWED`)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StorefrontErrorDto'
        '404':
          description: >-
            Shop/resource not found or the shop is blocked (`SHOP_NOT_FOUND`,
            `PRODUCT_NOT_FOUND`, `ORDER_NOT_FOUND`)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StorefrontErrorDto'
        '429':
          description: Rate limit exceeded (`RATE_LIMITED`)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StorefrontErrorDto'
      deprecated: true
components:
  schemas:
    StorefrontOrderStatusResponseDto:
      type: object
      properties:
        success:
          type: boolean
          example: true
        data:
          $ref: '#/components/schemas/StorefrontOrderStatusDto'
      required:
        - success
        - data
    StorefrontErrorDto:
      type: object
      properties:
        success:
          type: boolean
          example: false
        statusCode:
          type: number
          example: 404
        code:
          enum:
            - VALIDATION_FAILED
            - BAD_REQUEST
            - NOT_FOUND
            - SHOP_NOT_FOUND
            - PRODUCT_NOT_FOUND
            - ORDER_NOT_FOUND
            - PRODUCT_UNAVAILABLE
            - PRODUCT_VARIANT_REQUIRED
            - INVALID_PRODUCT_VARIANT
            - INVALID_QUANTITY
            - OUT_OF_STOCK
            - CART_EMPTY
            - NICK_REQUIRED
            - EMAIL_REQUIRED
            - CART_TOO_LARGE
            - DISCOUNT_INVALID
            - LEGAL_CONSENT_REQUIRED
            - LEGAL_DOCUMENTS_CHANGED
            - SHOP_PAYMENT_NOT_READY
            - PAYMENT_INIT_FAILED
            - ORDER_BLOCKED
            - RETURN_URL_NOT_ALLOWED
            - VOUCHER_NOT_FOUND
            - VOUCHER_USED
            - VOUCHER_EXPIRED
            - IDEMPOTENCY_KEY_REQUIRED
            - IDEMPOTENCY_KEY_REUSED
            - CHECKOUT_ATTEMPT_CLOSED
            - CHECKOUT_IN_PROGRESS
            - CAPTCHA_REQUIRED
            - ORIGIN_NOT_ALLOWED
            - FORBIDDEN
            - UNAUTHORIZED
            - PAYLOAD_TOO_LARGE
            - CONFLICT
            - RATE_LIMITED
            - SERVICE_UNAVAILABLE
            - INTERNAL_ERROR
          type: string
          description: Machine-readable error code — translate UI messages by this
          example: SHOP_NOT_FOUND
        message:
          type: string
          description: >-
            Developer message (language not guaranteed; do not show it to
            buyers)
          example: Shop not found
        error:
          type: string
          description: Same as `message` (compatibility with the rest of the API)
          example: Shop not found
          deprecated: true
        details:
          type: object
          description: Validation details
        timestamp:
          type: string
          format: date-time
          example: '2026-10-27T12:00:00.000Z'
        path:
          type: string
          example: /api/v2/storefront/v1/shops/moj-sklep
      required:
        - success
        - statusCode
        - code
        - message
        - error
        - timestamp
        - path
    StorefrontOrderStatusDto:
      type: object
      properties:
        orderId:
          type: string
          description: Order or payment group ID
          example: 664f1a2b3c4d5e6f7a8b9c0d
        orderNumber:
          type: string
          example: A1B2C3D4
        shopId:
          type: string
          example: 664f1a2b3c4d5e6f7a8b9c0d
        status:
          type: string
          enum:
            - pending
            - paid
            - processing
            - completed
            - cancelled
            - failed
            - dispute
            - refunded
            - partially_refunded
          description: >-
            For a group — the combined status of its lines (details in
            `items[]`)
          example: paid
        productName:
          type: string
          nullable: true
          description: 'For a group: lines, comma-separated'
          example: Ranga VIP
        serverName:
          type: string
          nullable: true
          example: Survival
        nick:
          type: string
          nullable: true
          description: Player nick, or a masked email in a `general` shop
          example: Steve
        amount:
          type: number
          nullable: true
          example: 19.99
        currency:
          type: string
          example: PLN
        createdAt:
          type: string
          format: date-time
          example: '2026-10-27T12:00:00.000Z'
        groupId:
          type: string
          nullable: true
          description: Payment group the order belongs to
          example: null
        items:
          description: Lines (one for a plain order)
          type: array
          items:
            $ref: '#/components/schemas/StorefrontOrderItemStatusDto'
        delivery:
          nullable: true
          description: >-
            Combined digital-delivery flag (null = no digital content). `ready`
            = some line can be collected
          type: object
          allOf:
            - $ref: '#/components/schemas/StorefrontDeliveryFlagDto'
      required:
        - orderId
        - orderNumber
        - shopId
        - status
        - productName
        - serverName
        - nick
        - amount
        - currency
        - createdAt
        - groupId
        - items
        - delivery
    StorefrontOrderItemStatusDto:
      type: object
      properties:
        orderId:
          type: string
          example: 664f1a2b3c4d5e6f7a8b9c0d
        orderNumber:
          type: string
          example: A1B2C3D4
        status:
          type: string
          enum:
            - pending
            - paid
            - processing
            - completed
            - cancelled
            - failed
            - dispute
            - refunded
          example: paid
        productName:
          type: string
          nullable: true
          example: Ranga VIP
        variant:
          type: string
          nullable: true
          example: 30 dni
        quantity:
          type: number
          example: 1
        serverName:
          type: string
          nullable: true
          example: Survival
        amount:
          type: number
          nullable: true
          example: 19.99
        delivery:
          nullable: true
          description: Digital delivery of the line; null = in game
          type: object
          allOf:
            - $ref: '#/components/schemas/StorefrontDeliveryFlagDto'
      required:
        - orderId
        - orderNumber
        - status
        - productName
        - variant
        - quantity
        - serverName
        - amount
        - delivery
    StorefrontDeliveryFlagDto:
      type: object
      properties:
        kind:
          type: string
          enum:
            - license_keys
            - download
            - text
            - mixed
          description: '`mixed` only in a group combined flag'
          example: license_keys
        state:
          type: string
          enum:
            - pending
            - awaiting_stock
            - delivered
            - revoked
          description: >-
            `pending` — awaiting payment/issue; `awaiting_stock` — paid, the
            seller is restocking (“awaiting delivery”); `delivered`; `revoked` —
            refund/dispute
          example: delivered
        ready:
          type: boolean
          description: Content can be collected (`GET …/delivery`)
          example: true
      required:
        - kind
        - state
        - ready

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.