API reference

Catalog

Browse dropship products, their variants, prices and stock.

get/catalog/productsBrowse dropship products get/catalog/products/{id}One product with variants, prices and stock get/catalog/categoriesCategory tree (only categories with dropship products)get/inventoryStock and price for up to 100 variants

Browse dropship products

get/catalog/products

Parameters

`search` query · string
`category` query · string	Category id (main or sub)
`minPrice` query · integer	Wholesale price, PKR
`maxPrice` query · integer
`inStock` query · boolean
`limit` query · integer	Default 50
`cursor` query · string	`nextCursor` from the previous page

Example request

curl "https://backend.markitmall.com/dropship/v1/catalog/products" \
  -H "Authorization: Bearer mk_test_XXXX:sk_test_XXXX"

Response 200

`data`required Product[]	—
`nextCursor`required string \| null	—

Example response

JSON

{
  "data": [
    {
      "id": "66f0c2a1b2c3d4e5f6a7b8c9",
      "title": "string",
      "description": "string",
      "images": [
        "https://example.com"
      ],
      "brand": "string",
      "tags": [
        "string"
      ],
      "category": {},
      "storeId": "66f0c2a1b2c3d4e5f6a7b8c9",
      "weightKg": 0,
      "wholesalePrice": 1500,
      "suggestedPrice": 1500,
      "compareAtPrice": 1500,
      "minResalePrice": 1500,
      "inStock": true,
      "stock": 0,
      "shipping": {
        "required": true,
        "weightKg": 0,
        "estimate": 0
      },
      "variants": [
        {
          "id": "66f0c2a1b2c3d4e5f6a7b8c9",
          "isDefault": true,
          "sku": "string",
          "color": "string",
          "size": "string",
          "title": "string",
          "image": "string",
          "wholesalePrice": 1500,
          "suggestedPrice": 1500,
          "minResalePrice": 1500,
          "stock": 0
        }
      ],
      "updatedAt": "2026-10-06T10:00:00.000Z"
    }
  ],
  "nextCursor": "string"
}

Errors: 401, 429 — the body is always { error: { code, message, details } }.

One product with variants, prices and stock

get/catalog/products/{id}

Parameters

idrequired

path · string

Example request

curl "https://backend.markitmall.com/dropship/v1/catalog/products/{id}" \
  -H "Authorization: Bearer mk_test_XXXX:sk_test_XXXX"

Response 200

Product

`id` string	—
`title` string	—
`description` string	HTML
`images` string[]	Copy them to your store — do not hotlink.
`brand` string \| null	—
`tags` string[]	—
`category` object \| null	—
`storeId` string	Products of different stores ship as separate parcels
`weightKg` number \| null	—
`wholesalePrice` integer	Lowest across variants
`suggestedPrice` integer	—
`compareAtPrice` integer \| null	—
`minResalePrice` integer	—
`inStock` boolean	—
`stock` integer	—
`shipping` object	What MarkitMall charges to deliver this product. `estimate` is one unit shipped on its own; a parcel is charged by its total weight (`x-markitmall-terms.shippingRates`), plus any city surcharge (`x-markitmall-terms.citySurcharges`), and items from different stores ship as separate parcels. `POST /shipping/quote` prices a whole cart.
`shipping.required` boolean	False when the store offers free delivery on it — we charge you none
`shipping.weightKg` number \| null	Null when unknown — the default shipping cost applies
`shipping.estimate` integer	PKR, one unit, no city surcharge
`variants` Variant[]	—
`updatedAt` string · date-time	—

Example response

JSON

{
  "id": "66f0c2a1b2c3d4e5f6a7b8c9",
  "title": "string",
  "description": "string",
  "images": [
    "https://example.com"
  ],
  "brand": "string",
  "tags": [
    "string"
  ],
  "category": {},
  "storeId": "66f0c2a1b2c3d4e5f6a7b8c9",
  "weightKg": 0,
  "wholesalePrice": 1500,
  "suggestedPrice": 1500,
  "compareAtPrice": 1500,
  "minResalePrice": 1500,
  "inStock": true,
  "stock": 0,
  "shipping": {
    "required": true,
    "weightKg": 0,
    "estimate": 0
  },
  "variants": [
    {
      "id": "66f0c2a1b2c3d4e5f6a7b8c9",
      "isDefault": true,
      "sku": "string",
      "color": "string",
      "size": "string",
      "title": "string",
      "image": "string",
      "wholesalePrice": 1500,
      "suggestedPrice": 1500,
      "minResalePrice": 1500,
      "stock": 0
    }
  ],
  "updatedAt": "2026-10-06T10:00:00.000Z"
}

Errors: 401, 404 — the body is always { error: { code, message, details } }.

Category tree (only categories with dropship products)

get/catalog/categories

Example request

curl "https://backend.markitmall.com/dropship/v1/catalog/categories" \
  -H "Authorization: Bearer mk_test_XXXX:sk_test_XXXX"

Response 200

data

Category[]

—

Example response

JSON

{
  "data": [
    {
      "id": "66f0c2a1b2c3d4e5f6a7b8c9",
      "name": "Ali Raza",
      "slug": "string",
      "children": [
        {
          "id": "66f0c2a1b2c3d4e5f6a7b8c9",
          "name": "Ali Raza",
          "slug": "string"
        }
      ]
    }
  ]
}

Errors: 401 — the body is always { error: { code, message, details } }.

Stock and price for up to 100 variants

get/inventory

Parameters

idsrequired

query · string

Comma-separated variant ids

Example request

curl "https://backend.markitmall.com/dropship/v1/inventory" \
  -H "Authorization: Bearer mk_test_XXXX:sk_test_XXXX"

Response 200

data

InventoryItem[]

—

Example response

JSON

{
  "data": [
    {
      "variantId": "66f0c2a1b2c3d4e5f6a7b8c9",
      "productId": "66f0c2a1b2c3d4e5f6a7b8c9",
      "available": true,
      "stock": 0,
      "wholesalePrice": 1500,
      "minResalePrice": 1500
    }
  ]
}

Errors: 400, 401 — the body is always { error: { code, message, details } }.