# Postman API

**Provider:** Postman
**Category:** developer
**Base URL:** `https://api.postman.com`
**Auth:** api-key — `X-API-Key: PMAK-...`
**Rate Limit:** 300 requests/min
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://learning.postman.com/docs/developer/postman-api/intro-api/

## Description

The Postman API lets you automate and integrate your API development workflows. Manage workspaces, import and export collections, sync environments, spin up mock servers, trigger monitor runs, and retrieve usage analytics — all via REST. Used for CI/CD integrations, team automation, and platform engineering workflows. The API mirrors Postman's web interface for full programmatic control.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.postman.com/workspaces` | List all workspaces in your team |
| GET | `https://api.postman.com/collections` | List all collections (optionally filter by workspace) |
| POST | `https://api.postman.com/collections` | Create a new collection from a definition |
| PUT | `https://api.postman.com/collections/{collectionId}` | Replace an entire collection |
| GET | `https://api.postman.com/environments` | List all environments in a workspace |
| POST | `https://api.postman.com/environments` | Create a new environment with variables |
| GET | `https://api.postman.com/mocks` | List all mock servers |
| POST | `https://api.postman.com/mocks` | Create a mock server from a collection |
| GET | `https://api.postman.com/monitors` | List all monitors with schedule and status |
| POST | `https://api.postman.com/monitors/{monitorId}/run` | Trigger an immediate monitor run |
| GET | `https://api.postman.com/apis` | List all API definitions in a workspace |
| GET | `https://api.postman.com/me` | Get current authenticated user info and usage |

## Authentication

Generate a Postman API key in your account settings. Pass it in the X-API-Key request header on every request.

```
X-API-Key: PMAK-...
```

## Sample Request

```bash
curl "https://api.postman.com/collections" \
  -H "X-API-Key: $POSTMAN_API_KEY"
```

## Sample Response

```json
{
  "collections": [
    {
      "id": "abc123",
      "name": "My API Collection",
      "owner": "1234567",
      "uid": "1234567-abc123",
      "updatedAt": "2024-03-15T10:30:00.000Z",
      "isPublic": false,
      "fork": null
    }
  ]
}
```

## Pricing Details

Free: 1 user, basic features. Solo $9/mo: AI features + extended usage. Team $19/user/mo: collaboration, role-based access, SSO add-on. Enterprise $49/user/mo: SSO, audit logs, custom roles, advanced security.

---

*Source: [API Map](https://apimap.dev/apis/postman/) — CC BY 4.0*