Getting Started

PaperStack provides reliable, structured exam data APIs for Indian competitive exams. This guide will take you from zero to your first API response.

What We Offer

Base URL

All API requests are made to the following base URL:

https://api.paperstack.qzz.io

Quick Start (2 Minutes)

1. Create an Account

Register for a free account. No credit card required.

2. Generate an API Key

Log in to your Dashboard and click Generate New Key. Your key will start with ps_.

Important: Copy your key immediately. It will only be shown once.

3. Make Your First Request

curl -H "Authorization: Bearer ps_your_api_key_here" \
  https://api.paperstack.qzz.io/neet/2024/s1/physics.json

4. Explore Available Data

List all available years for an exam:

curl https://api.paperstack.qzz.io/neet

{
  "exam": "neet",
  "label": "NEET",
  "years": [2024, 2023, 2022, 2021, 2020],
  "totalYears": 5
}

List shifts for a specific year:

curl https://api.paperstack.qzz.io/neet/2024

{
  "exam": "neet",
  "year": 2024,
  "shifts": [
    {
      "shift": "2024-05-05-s1",
      "subjects": ["physics", "chemistry", "biology"],
      "total": 200,
      "lastUpdated": "2025-12-01",
      "checksum": "a1b2c3d4"
    }
  ]
}

Anatomy of a URL

/{exam}/{year}/{shift}/{file}
     ↑       ↑       ↑      ↑
   exam    year    shift  filename

Smart Shift Resolution: You can use shorthand like s1 or s2 instead of the full shift name. PaperStack will resolve it automatically.

What You Get

Each question file contains structured JSON with:

• Question text and images/diagrams (where applicable)
• Answer key with correct option
• Subject and topic tags
• Difficulty level (Easy, Medium, Hard)
• Unique question ID for cross-referencing
• Checksum per dataset for integrity verification

Next Steps

• Read the Authentication guide for detailed API key usage
• Browse the API Reference for interactive endpoint exploration
• View your usage and manage keys on the Dashboard