Postman collection organization in Rest API - Mini Project: Build & Apply

Organize a Postman Collection for API Testing

📖 Scenario: You are working as a junior API tester. Your team uses Postman to test APIs. Currently, the Postman collection is messy with all requests in one folder. You want to organize the collection by grouping requests into folders based on their API resource type.

🎯 Goal: Create a Postman collection JSON structure with organized folders. Each folder groups related API requests. This helps your team find and run tests easily.

📋 What You'll Learn

Create a Postman collection JSON with a info section containing name and schema

Add two folders named Users and Products inside the item array

Add one GET request named Get User inside the Users folder with the URL https://api.example.com/users/1

Add one GET request named Get Product inside the Products folder with the URL https://api.example.com/products/1

💡 Why This Matters

🌍 Real World

Organizing Postman collections helps teams manage and run API tests efficiently, especially when APIs grow larger.

💼 Career

API testers, developers, and QA engineers often organize Postman collections to improve collaboration and testing workflows.

1

Create the basic Postman collection structure

Create a JSON object called collection with an info section. The info section must have name set to My API Tests and schema set to https://schema.getpostman.com/json/collection/v2.1.0/collection.json. Also add an empty item array to hold folders.

Rest API

{
  "info": {
    "name": "My API Tests",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    // Your code here
  ]
}

Need a hint?

Start by creating the main JSON object with info and an empty item array.

2

Add folders for Users and Products

Add two folders inside the item array of collection. Each folder is an object with a name and an empty item array. The first folder's name is Users and the second folder's name is Products.

Rest API

{
  "info": {
    "name": "My API Tests",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    // Add Users and Products folders here
  ]
}

Need a hint?

Folders are objects inside the item array with their own name and item arrays.

3

Add a GET request to the Users folder

Inside the Users folder's item array, add a GET request object. The request should have name set to Get User and a request object with method set to GET and url set to https://api.example.com/users/1.

Rest API

{
  "info": {
    "name": "My API Tests",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Users",
      "item": [
        // Add Get User request here
      ]
    },
    {
      "name": "Products",
      "item": []
    }
  ]
}

Need a hint?

Requests go inside the folder's item array as objects with name and request details.

4

Add a GET request to the Products folder

Inside the Products folder's item array, add a GET request object. The request should have name set to Get Product and a request object with method set to GET and url set to https://api.example.com/products/1.

Rest API

{
  "info": {
    "name": "My API Tests",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Users",
      "item": [
        {
          "name": "Get User",
          "request": {
            "method": "GET",
            "url": "https://api.example.com/users/1"
          }
        }
      ]
    },
    {
      "name": "Products",
      "item": [
        // Add Get Product request here
      ]
    }
  ]
}

Need a hint?

Similar to the Users folder, add the request inside the Products folder's item array.