Getting SKU Details

This call fetches the information listed against the specified SKUs. If the SKU does not exist in the system, then it will be identified in the unavailable field in the response.

Request - v3 API

POST https://api.flipkart.net/listings/v3/{sku-ids}

Request params (v3)

Required sku-ids - Comma-separated list of SKU Ids. Maximum per call: 10.

Request Example (v3)

function getRequest(headers: BEARER_AUTH, ids: Array<String>) {
  return fetch(`https://api.flipkart.net/listings/v3/${ids.join(',')}`, {
    headers
  })
  .then(r => {
    // Response Object
  })

Response Body Schema (v3)

const Dimension = {
    type: "object",
    properties: {
        length: { type: "number" },
        breadth: { type: "number" },
        height: { type: "number"},
    },
}

const NotionalValue = {
    type: "object",
    properties: {
        amount: { type: "number", minimum: 0 },
        unit: { type: "string", enum: ['PERCENTAGE', 'INR'] },
    },
}

const Handling = {
    type: "object",
    properties: {
        fragile: { type: "boolean" },
    },
}

const Package = {
    type: "object",
    properties: {
        id: { type: "string" },
        name: { type: "string" },
        dimensions: Dimension,
        weight: { type: "number"},
        notional_value: NotionalValue,
        description: { type: "string"},
        handling: Handling,
    },
}

const shippingFee = {
    type: "object",
    properties: {
        local: { type: "integer", minimum: 0 },
        zonal: { type: "integer", minimum: 0 },
        national: { type: "integer", minimum: 0 },
        currency: { type: "string"},
    },
    required: ["local", "zonal", "national", "currency"],
}

const tax = {
    type: "object",
    properties: {
        hsn: { type: "string" },
        is_gst_sellable: { type: "boolean" },
        goods_services_rate: { type: "string", minimum: 0, Maximum: 28 },
        tax_code: { type: "string" },
        luxury_cess_percentage: { type: "number", minimum: 0, Maximum: 100 },
    },
    required: ["hsn"],
}

const price = {
    type: "object",
    properties: {
        mrp: { type: "integer", minimum: 0 },
        selling_price: { type: "integer", minimum: 0 },
        mop: { type: "integer"},
        nlc: { type: "integer"},
        dealer_price: { type: "integer"},
        currency: { type: "string" },
    },
    required: ["mrp", "selling_price", "price", "listing_status", "fulfillment_profile"],
}

const Location = {
    type: "object",
    properties: {
        id: { type: "string" },
        status: { type: "string", enum: [ ENABLED, DISABLED ] },
        inventory: { type: "integer"},
        pending_inventory: { type: "integer"},
    },
    required: ["id", "status"],
}

const MarketplaceListingDetail = {
    type: "object",
    properties: {
        listing_id: { type: "string" },
        product_id: { type: "string" },
        price: price,
        tax: tax,
        listing_status: { type: "string", enum: [ ACTIVE, INACTIVE ] },
        shipping_fees: shippingFee,
        fulfillment_profile: { type: "string", enum: [ NON_FBF, FBF_LITE, FBF ] },
        packages: Package,
        locations: Location,
        archived_status: { type: "string", enum: [ ARCHIVED, NONE ] },
    },
    required: ["listing_id", "product_id", "price", "listing_status", "fulfillment_profile"],
}

const GetMarketplaceListingDetailsResponse = {
    type: "object",
    properties: {
        available: { type: "object ", properties: { "key": 	MarketplaceListingDetail } },
        unavailable: { type: "array", uniqueItems: true, items: { type: "string" } },
        invalid: { type: "array", uniqueItems: true, items: { type: "string" } },
    },
    required: ["available"],
}

Success Response Example (v3)

// status: 200
{
  available: {
    AN1004_RED_YELLOW: {
      listing_id: 'LSTUMBF5D4DEAFDEWSGBM0UJY',
      product_id: 'UMBF5D4DEAFDEWSG',
      price: { mrp: 798, selling_price: 550, currency: 'INR' },
      tax: { hsn: '66019900', tax_code: 'GST_12' },
      listing_status: 'ACTIVE',
      shipping_fees: { local: 30, zonal: 40, national: 50, currency: 'INR' },
      fulfillment_profile: 'NON_FBF',
      packages: [
        {
          id: 'PKGUMBF5D4DEAFDEWSGBM0UJY',
          name: 'AN1004_RED_YELLOW',
          dimensions: { length: 35, breadth: 6, height: 6 },
          weight: 0.3,
          handling: { fragile: false }
        }
      ],
      locations: [
        {
          id: 'LOCbba44916f16b474da588ed9b28768c43',
          status: 'ENABLED',
          inventory: 49,
          pending_inventory: 0
        }
      ],
      order_policy: { maximum_allowed_quantity: 5, independent_sellable: true },
      archived_status: 'NONE'
    }
  }
}

Possible Error Response Codes (v3)