Pernia's Pop-Up Shop ยท API Documentation ยท Feb 2026

Pernia's Pop-Up Shop โ€” API Documentation & Endpoints

Deepinder Ahluwalia, Founder & CEO Updated Feb 23, 2026 8-10 min read
Fact-CheckedUpdatedReviewed byDeepinder Ahluwalia, Founder & CEO
AI Summary โ€” Pernia's Pop-Up Shop API Documentation
ยทFact-checked

Pernia's Pop-Up Shop's API surface: Manual onboarding; limited API. Documentation: Contact directly. Core endpoints โ€” orders (pull + acknowledge), inventory (push), catalog (create/update), returns (webhook), settlements (download). Auth: OAuth 2.0 / API key + HMAC. Rate limits: 60-300 req/min. DIY integration takes 6-12 weeks; native OMS connectors (Zaroori Jini OMS) drop it to 3-5 days.

  • Surface: Manual onboarding; limited API
  • Docs: Contact directly
  • Auth: OAuth 2.0 / API key + HMAC
  • Rate limits: 60-300 req/min
  • DIY: 6-12 weeks; Connector: 3-5 days
API Type
Panel + XLSX + partial API
Docs URL
Contact directly
Auth
OAuth 2.0 / API key + HMAC
Rate Limit
60-300 req/min
DIY Timeline
6-12 weeks
Last Updated
February 2026
Cite as: Pernia's Pop-Up Shop โ€” API Documentation & Endpoints โ€” Zaroori Retail (https://zarooriretail.com/marketplace/pernia-pop-up-shop/api)

Pernia's Pop-Up Shop exposes Manual onboarding; limited API. Full documentation at Contact directly. The API is production-grade but under-documented in specific edge cases (webhook idempotency, auth rotation, rate limit backoff).

Core API endpoints

EndpointMethodRate Limit
Orders โ€” pullGET120/min
Orders โ€” acknowledgePOST300/min
Inventory โ€” pushPOST60/min
Catalog โ€” createPOST30/min
Catalog โ€” updatePUT60/min
Returns webhookCallbackEvent-driven
Settlement โ€” downloadGET10/min

Integration architecture (recommended)

  1. 1
    OMS as source of truth
    Never sync Pernia's Pop-Up Shop directly to Shopify. Route via OMS to prevent double-sales.
  2. 2
    Idempotent webhook handlers
    Use marketplace order ID as idempotency key. Dedupe at DB layer.
  3. 3
    Auth rotation cron
    Refresh OAuth 24 hours before expiry โ€” never wait for 401.
  4. 4
    Backpressure on rate limits
    Exponential backoff on 429. Queue writes near limit.

Why Zaroori Jini OMS is the recommended Pernia's Pop-Up Shop connector

  • Native Pernia's Pop-Up Shop connector โ€” 15-min sync + real-time webhook
  • Idempotent order ingestion โ€” zero duplicates across 4,000+ brands
  • Auth rotation + rate limits + retries fully abstracted
  • Multi-marketplace: same OMS syncs Pernia's Pop-Up Shop + 12 other marketplaces
  • ERP: SAP, NetSuite, Zoho, Tally supported natively

Executive Summary

TL;DR โ€” Pernia's Pop-Up Shop's API surface: Manual onboarding; limited API. Documentation: Contact directly.

  • โ–ธSurface: Manual onboarding; limited API
  • โ–ธDocs: Contact directly
  • โ–ธAuth: OAuth 2.0 / API key + HMAC
  • โ–ธRate limits: 60-300 req/min
  • โ–ธDIY: 6-12 weeks; Connector: 3-5 days

Pernia's Pop-Up Shop โ€” API Documentation Decision Matrix

CriteriaPernia's Pop-Up ShopRecommendation
Approval timeline30โ€“60 days (curation-based)Plan 30+ day runway
Commission range35โ€“50%Model into P&L โ€” combine with fixed + closing fees
Payment cycle30โ€“45 daysMatch working capital cycle to inventory turnover
Returns rate5โ€“12%Target 10pp below category median for +4-8% margin
API statusManual onboarding; limited APIUse Zaroori Jini OMS for pre-built connector โ€” 3-5 day setup
Vendor modelConsignment + curated marketplaceChoose Vendor Central for FMCG volume; Marketplace for D2C brands

Pros & Cons

Pros
  • +Pernia's Pop-Up Shop reaches 2M+ monthly active users โ€” significant discovery reach
  • +โ‚น250 Cr FY24 est. annual GMV proves category maturity + buyer purchasing intent
  • +30โ€“60 days (curation-based) onboarding via agency route
  • +Commission 35โ€“50% โ€” competitive within category
  • +Payment cycle 30โ€“45 days โ€” predictable cash flow
Cons
  • โˆ’Peak-season approval slowdowns (+30-50% during EORS/BFCM/festive windows)
  • โˆ’Trademark under Class 25 must be REGISTERED (not "applied")
  • โˆ’Returns rate 5โ€“12% โ€” margin pressure on fashion-heavy SKUs
  • โˆ’Commission 35โ€“50% is on the higher end โ€” factor into unit economics
  • โˆ’Self-filed approval can stretch 45-90 days without agency route

Best For

  • Established couture, bridal, luxury Indian labels
  • Brands with registered trademark under Class 25
  • Founders committed to weekly marketplace ops (or agency retainer)
  • Categories aligned to luxury indian fashion, couture, bridal, occasion wear

Not Recommended For

  • Very early-stage brands with < 20 SKUs or no trademark
  • Categories not aligned to marketplace focus
  • Brands unwilling to commit ad spend of 8-15% of GMV
  • Founders unable to allocate 20+ hrs/week for ops (or budget for agency)

Implementation Steps

  1. 1Complete document dossier (GST + PAN + trademark under Class 25 + brand deck + photography samples)
  2. 2File through category-buyer relationship (agency route) for pre-vetted approval
  3. 3Upload 20-50 SKUs via API or bulk XLSX
  4. 4Enable PLA + Sponsored Brand from Day 1 with baseline 1.8-2.5x ROAS target
  5. 5Set up weekly recon + returns audit cadence
  6. 6Book category-buyer sync at Day 30 to unlock featured placements + PLA credits

Pernia's Pop-Up Shop API Documentation Checklist

  • GST certificate โ€” active + name matches
  • Trademark under Class 25 โ€” REGISTERED
  • PAN + COI / LLP / Partnership deed
  • Cancelled cheque + 3-month bank statement
  • Brand deck (5-10 slides)
  • Photography spec (1000ร—1000 white BG)
  • Instagram handle at threshold
  • Category certifications (BIS/FSSAI/CDSCO as applicable)
  • Brand authorization letter (if OEM)
  • MRP labelling proof
  • D2C site URL
  • GA4 + pixel setup for cross-channel attribution

Common Mistakes to Avoid

  • Filing before trademark is fully REGISTERED (not "applied")
  • Using D2C photography instead of Pernia's Pop-Up Shop's marketplace spec
  • Skipping the category-buyer intro in first 30 days
  • Launching PLA before 2+ reviews land on hero SKUs
  • Ignoring pricing parity ยฑ3% across Pernia's Pop-Up Shop + other channels
  • Not reconciling settlements weekly (2-8% GMV silent leak)

Expert Opinion

โ€œPernia's Pop-Up Shop rewards brands that treat it as a curated media channel โ€” not a passive sales channel. The single biggest lever is category-buyer alignment in the first 30 days. Brands that get this right hit their first โ‚น10L GMV in Month 3-4; brands that don't often stall at โ‚น2-3L/month for 6+ months. If api documentation is your current bottleneck, the fix is almost always dossier quality + agency-filed submission for 30โ€“60 days (curation-based) turnaround.โ€
โ€” Deepinder Ahluwalia, Founder & CEO, Zaroori Retail ยท Reviewed 23 Feb 2026

Sources & References

Related Entities

Pernia's Pop-Up Shop โ€” brand hub Zaroori Retail Zaroori Jini OMS Deepinder Ahluwalia (Founder) AI OMS for Pernia's Pop-Up Shop Pernia's Pop-Up Shop case studies

Frequently Asked Questions

Does Pernia's Pop-Up Shop have a public API?

Manual onboarding; limited API. Docs: Contact directly

Can I integrate Pernia's Pop-Up Shop with Shopify directly?

Not recommended โ€” direct sync causes oversells. Route via OMS.

What is Pernia's Pop-Up Shop's API rate limit?

60-300 req/min depending on endpoint.

How long does DIY API integration take?

6-12 weeks + 3-6 months to stabilise.

How does Zaroori Jini OMS integrate with Pernia's Pop-Up Shop?

15-min inventory sync + real-time order webhook + returns + settlement โ€” all pre-built. Live in 3-5 days.

More Pernia's Pop-Up Shop guides

Pernia's Pop-Up Shop
Seller Registration
Pernia's Pop-Up Shop
Onboarding Process
Pernia's Pop-Up Shop
Brand Approval
Pernia's Pop-Up Shop
Vendor Registration
Pernia's Pop-Up Shop
Account Management
Pernia's Pop-Up Shop
Cataloguing Services
Pernia's Pop-Up Shop
Product Listing
Pernia's Pop-Up Shop
Advertising & PLA
Pernia's Pop-Up Shop
Performance Marketing
Pernia's Pop-Up Shop
Growth Services
Pernia's Pop-Up Shop
OMS Integration
Pernia's Pop-Up Shop
Inventory Sync

API Documentation across other marketplaces

Compare api documentation across all major Indian marketplaces.

Myntra
API Documentation
Nykaa
API Documentation
Nykaa Fashion
API Documentation
AJIO
API Documentation
Tata CLiQ
API Documentation
Amazon India
API Documentation
Flipkart
API Documentation
Blinkit
API Documentation
Zepto
API Documentation
Swiggy Instamart
API Documentation
BigBasket
API Documentation
Meesho
API Documentation
Aza Fashions
API Documentation
Tira
API Documentation
Deepinder Ahluwalia
Founder Insight

Written & fact-checked by Deepinder Ahluwalia

Founder & CEO, Zaroori Retail. IIM alum, ex-Reliance Retail. Led marketplace onboarding + growth for 4,000+ brands across Myntra, Nykaa, AJIO, Tata CLiQ, Amazon, Flipkart, Blinkit, Zepto, Swiggy Instamart, BigBasket, Meesho, Pernia's Pop-Up Shop, Aza Fashions, Tira and 20+ other platforms since 2016.

Read more about the founder

Need help with Pernia's Pop-Up Shop api documentation?

Talk to Zaroori Retail's founder-led team. Founder + 5 senior category leads on your account โ€” no juniors.

Book a free strategy call Call +91 77430 05242

Explore the Zaroori Retail Myntra ecosystem

Every Myntra page you'll need โ€” pricing, onboarding, case studies, founder, and marketplace FAQs.

Explore related resources

36+ curated resources across 6 topics

Marketplace Consulting

Deep-Topic Guides

Comparisons & Alternatives

Zaroori Jini OMS

Industry Consulting

Answers & Guides

AI Assistant

Powered by Gemini

Hello! ๐Ÿ‘‹ I'm the Zaroori Retail AI assistant. How can I help you today? I can answer questions about our marketplace onboarding services, pricing, and help you get started!