> For the complete documentation index, see [llms.txt](https://developer.paddle.com/llms.txt).

# Postman collection

Import the Paddle Postman collection to explore and test the Paddle Billing API interactively.

---

Postman is the quickest way to explore and test the Paddle Billing API. The Paddle Postman collection includes every operation, so you can try the API interactively before writing code.

{% callout type="success" icon="verified" %}
Paddle are a verified publisher on the Postman Public API network, which means our API meets a high standard of quality, reliability, and AI-readiness.
{% /callout %}

## Get the collection

To get started, for the Paddle Postman collection. Postman walks you through authentication and making your first request.

[Fork our Postman collection to get started with the API](https://god.gw.postman.com/run-collection/29428794-16aca740-3ad6-4c1a-97be-05dbc504b4c3?action=collection%2Ffork&source=rip_markdown&collection-url=entityId%3D29428794-16aca740-3ad6-4c1a-97be-05dbc504b4c3%26entityType%3Dcollection%26workspaceId%3D5ed2587a-f47e-43e0-810c-0c3e782bca12#?env%5BSandbox%5D=W3sia2V5IjoiYmFzZVVybCIsInZhbHVlIjoiaHR0cHM6Ly9zYW5kYm94LWFwaS5wYWRkbGUuY29tIiwiZW5hYmxlZCI6dHJ1ZSwidHlwZSI6ImRlZmF1bHQifSx7ImtleSI6ImJlYXJlclRva2VuIiwidmFsdWUiOiIiLCJlbmFibGVkIjp0cnVlLCJ0eXBlIjoic2VjcmV0In1d)

## When to use

- **Quickstart**  
  Fork the collection in one-click, let Postman walk you through authentication, then make your first request.
- **Explore**  
  Tap through the Paddle API to understand shapes, required fields, and response structures.
- **Codegen**  
  Generate a client in a language Paddle doesn't ship an SDK for.
- **Prototype**  
  Test an integration idea with real sandbox data before committing to implementation.

{% callout type="note" %}
Use [Agent Mode in Postman](https://www.postman.com/product/agent-mode/) to explore, debug, and build APIs using natural language. Postman AI can fix broken requests, write test scripts, generate docs, organize collections, and build custom MCP servers.
{% /callout %}

## Authenticate

When you fork the collection, Postman guides you through setting the `bearerToken` and `baseUrl` environment variables:

| Variable       | Where to find it                                                            |
| -------------- | --------------------------------------------------------------------------- |
| `bearerToken` | **Paddle > Developer tools > Authentication**. Use a [sandbox](https://developer.paddle.com/sdks/sandbox.md) key for exploration. |
| `baseUrl` | `https://sandbox-api.paddle.com` for sandbox or `https://api.paddle.com` for live. |

Add multiple environments to your forked collection to switch between sandbox and live.