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

# Get a reseller order

> One reseller order whole, as the dashboard's page for it shows it: who bought it (`reseller`, and `boughtBy`, the member of their team), how (`via`), the `total` taken off their balance, `listTotal` (what it came to at the panel's list prices when bought) and `discount` (what their price took off it), both null for an order from before those were kept, and `balanceAfter`. Each of `lines` is an option it bought, with its `unitPrice` and `quantity` and what it delivered: `keys`, `items` (what a dynamic delivery's server handed back, a line each), `instructions`, and `waiting` while a dynamic line is still being fetched. A store's own order or a top-up answers 404.

Needs the `resellers.read` permission (Read Resellers).



## OpenAPI

````yaml /api-reference/openapi.json get /stores/{storeId}/resellers/orders/{orderId}
openapi: 3.1.0
info:
  title: Shoply API
  version: '1'
  description: >-
    Everything a store's own server can do with a secret API key: its catalogue,
    orders, customers, marketing, finance and the rest of what the dashboard
    does. And the Customer API, which a buyer's own device asks with a token of
    theirs.
servers:
  - url: https://api.shoply.gg/v1
security:
  - apiKey: []
tags:
  - name: API key
  - name: Store
  - name: Domain
  - name: Payment methods
  - name: Analytics
  - name: Storefronts
  - name: Storefront code
  - name: Payment Routing
  - name: Custom payment methods
  - name: Products
  - name: Product pictures
  - name: Stock
  - name: Categories
  - name: Upsells
  - name: Subscriptions
  - name: Orders
  - name: Invoices
  - name: Reviews
  - name: Coupons
  - name: Coupon categories
  - name: Coupon pop-up
  - name: Sales
  - name: Blog
  - name: Search settings
  - name: Redirects
  - name: Sitemap
  - name: Cart Recovery
  - name: Email Marketing
  - name: Email Templates
  - name: Customers
  - name: Affiliates
  - name: Support Tickets
  - name: Teams
  - name: Resellers
  - name: Blacklist
  - name: Allowlist
  - name: Fraud protection
  - name: Disputes
  - name: Finance
  - name: Tax
  - name: Expenses
  - name: Expense setup
  - name: API requests
  - name: Webhook endpoints
  - name: Webhook deliveries
  - name: Customer API
paths:
  /stores/{storeId}/resellers/orders/{orderId}:
    get:
      tags:
        - Resellers
      summary: Get a reseller order
      description: >-
        One reseller order whole, as the dashboard's page for it shows it: who
        bought it (`reseller`, and `boughtBy`, the member of their team), how
        (`via`), the `total` taken off their balance, `listTotal` (what it came
        to at the panel's list prices when bought) and `discount` (what their
        price took off it), both null for an order from before those were kept,
        and `balanceAfter`. Each of `lines` is an option it bought, with its
        `unitPrice` and `quantity` and what it delivered: `keys`, `items` (what
        a dynamic delivery's server handed back, a line each), `instructions`,
        and `waiting` while a dynamic line is still being fetched. A store's own
        order or a top-up answers 404.


        Needs the `resellers.read` permission (Read Resellers).
      operationId: resellerOrders.get
      parameters:
        - name: storeId
          in: path
          required: true
          description: >-
            The store's ID. A key reaches the store it was made in: `GET /key`
            answers which.
          schema:
            type: string
        - name: orderId
          in: path
          required: true
          description: The reseller order, by its ID as List reseller orders answers it.
          schema:
            type: string
      responses:
        '200':
          description: It worked.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  message:
                    nullable: true
                  code:
                    nullable: true
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      status:
                        type: string
                      via:
                        type: string
                      currency:
                        type: string
                      total:
                        type: integer
                      listTotal:
                        type: integer
                      discount:
                        type: integer
                      balanceAfter:
                        type: integer
                      createdAt:
                        type: string
                      reseller:
                        type: object
                        properties:
                          id:
                            type: string
                          name:
                            type: string
                          removed:
                            type: boolean
                      boughtBy:
                        type: string
                      goodsShown:
                        type: boolean
                      lines:
                        type: array
                        items:
                          type: object
                          properties:
                            productId:
                              type: string
                            productName:
                              type: string
                            variantName:
                              type: string
                            unitPrice:
                              type: number
                            quantity:
                              type: integer
                            delivered:
                              type: integer
                            keys:
                              type: array
                              items:
                                type: string
                            items:
                              type:
                                - array
                                - object
                            waiting:
                              type: boolean
                            instructions:
                              type: string
              example:
                success: true
                message: null
                code: null
                data:
                  id: d3df5h0p1y5-237c6132eac-1036609
                  status: completed
                  via: panel
                  currency: USD
                  total: 13
                  listTotal: 13
                  discount: 0
                  balanceAfter: 37
                  createdAt: '2026-11-09T11:32:36Z'
                  reseller:
                    id: 5802fdf5-5c97-40bb-b505-29a900c278e4
                    name: keydepot.example.com
                    removed: false
                  boughtBy: team@keydepot.example.com
                  goodsShown: true
                  lines:
                    - productId: 7626c760-c6cd-4b38-8344-cfbba0148a80
                      productName: Northwind Pro
                      variantName: 1 month
                      unitPrice: 6.5
                      quantity: 2
                      delivered: 2
                      keys:
                        - NWPRO-69A561B71981
                        - NWPRO-R5L1-0K2D-7AQX
                      items: []
                      waiting: false
                      instructions: ''
        '401':
          $ref: '#/components/responses/NoKey'
        '403':
          $ref: '#/components/responses/NotAllowed'
        '404':
          $ref: '#/components/responses/NotFound'
        '429':
          $ref: '#/components/responses/TooMany'
      x-codeSamples:
        - lang: javascript
          label: Node.js
          source: |
            import Shoply from "@shoplygg/node";

            const shoply = new Shoply({ apiKey: process.env.SHOPLY_API_KEY });

            const result = await shoply.resellerOrders.get("ORDER_ID");
        - lang: php
          label: PHP
          source: |
            <?php

            require 'vendor/autoload.php';

            $shoply = new Shoply\Client(['apiKey' => getenv('SHOPLY_API_KEY')]);

            $result = $shoply->resellerOrders->get('ORDER_ID');
        - lang: python
          label: Python
          source: |
            import shoply

            client = shoply.Client()  # reads SHOPLY_API_KEY

            result = client.resellerOrders.get("ORDER_ID")
components:
  responses:
    NoKey:
      description: >-
        No API key was sent, or the one sent is not a live key:
        `api_key_required`, `invalid_api_key`.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Refusal'
    NotAllowed:
      description: >-
        The key is real and may not do this: `missing_scope` (with
        `requiredScope`), `ip_not_allowed`, `account_unavailable`, or
        `dashboard_only` for something only a person in the dashboard may do.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Refusal'
    NotFound:
      description: >-
        There is no such thing in this store: `not_found`. A store that is not
        the key's own is answered the same way.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Refusal'
    TooMany:
      description: >-
        The key has used up its budget for now: `rate_limited`. `Retry-After`
        says how many seconds to wait.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Refusal'
  schemas:
    Refusal:
      type: object
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
          description: What is wrong, in words for a person.
        code:
          type: string
          description: What is wrong, as a word that does not change.
        data:
          nullable: true
        errors:
          type: object
          description: >-
            For `validation_failed`: what is wrong with each field, by the
            field's name.
          additionalProperties:
            type: string
      required:
        - success
        - message
        - code
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: >-
        A secret API key, made under Developers in the dashboard:
        `Authorization: Bearer shoply_sk_...`

````

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