Announcing the Vonage APIs Postman Collection
Tags: developer, bestpractice, openapi, postman
Published: 2020-10-19 14:01:52

---
title: Announcing the Vonage APIs Postman Collection
published: true
date: 2020-09-16 10:53:56 UTC
tags: Developer,bestpractice,OpenAPI,postman
canonical_url: https://www.nexmo.com/blog/2020/09/16/announcing-the-vonage-apis-postman-collection
---

At Vonage, we publish OpenAPI specifications for all our APIs. These specs enable our developer community to explore, evaluate, and integrate the Vonage APIs efficiently.

As [Lorna](https://twitter.com/lornajane) mentioned in her article on [evaluating APIs using OpenAPI](https://dev.to/nexmodev/evaluate-apis-quickly-and-easily-with-openapi-1g3c-temp-slug-175183), downloading an [OpenAPI Spec](https://developer.nexmo.com/concepts/guides/openapi) and exploring it in [Postman](https://www.postman.com/) is a great way to familiarize yourself with new APIs.

I couldn’t agree more! If you’re not already familiar with [Postman](https://www.postman.com/), it’s a friendly graphical interface to a powerful cross-platform HTTP client that I encourage you to try.

We’re excited to announce that exploring the Vonage APIs has just gotten even quicker and easier! We’ve added a “Run in Postman” button to the [Postman page on our developer portal](https://developer.nexmo.com/tools/postman), so now you’re only a couple of clicks away from making your first request.

It is also discoverable on the [main Postman network](https://explore.postman.com/network/search?q=vonage) if you’d rather browse it there.

Once you click on the **Run in Postman** button, you’ll be taken to your Postman instance of choice, and all of the Vonage API Calls will be waiting for you, nicely organized into a collection.

![Vonage APIs Postman collection imported view](https://www.nexmo.com/wp-content/uploads/2020/09/vonage-apis-postman-collection.png)

A great thing about using a Postman Collection is that we can prepare the requests for you, so there’s minimal work involved in making the API calls.

It also has some neat features, like the ability to configure environment variables. This collection comes with a **Vonage Environment** that lists _API\_KEY_, _API\_SECRET_, and _JWT_, which are the most commonly used parameters, but feel free to add others as you go. You can find the environments by clicking the cog icon in the top right-hand corner.

![Vonage environment variables in Postman Collection](https://www.nexmo.com/wp-content/uploads/2020/09/postman-environment-variables.png)

To add your credentials, update the current values of _API\_KEY_ and _API\_SECRET_ with the API key and secret found in your [Vonage dashboard](dashboard.nexmo.com/) (no need to set up JWT for now).

## Using the Vonage APIs Postman Collection

Next, let’s have a closer look at using the Vonage APIs Postman Collection to explore the [_Numbers API_](https://developer.nexmo.com/numbers/overview).

Expand the collection folder and find the _Numbers_ folder inside it.

![Numbers requests in Vonage APIs Postman collection](https://www.nexmo.com/wp-content/uploads/2020/09/numbers-in-postman-collection.png)

Vonage’s Numbers API allows you to manage your virtual number inventory programmatically. To find out more about the available operations, make sure to check out the [Numbers API Reference](https://developer.nexmo.com/api/numbers?theme=dark).

For this example, let’s try out the _List numbers you own_ entry.

Your `api_key` and `api_secret` will be pulled in dynamically from the Vonage Environment, so double-check that you’ve set those values in the environment, then click send.

![Numbers API List numbers you own response body](https://www.nexmo.com/wp-content/uploads/2020/09/numbers-api-postman-request-body.png)

Et voilà! You’ve successfully made your fist Vonage API request using our Postman collection!

Give it a try, have fun, and let us know what you think!

## Where Next?

- [Vonage APIs Postman Collection](https://developer.nexmo.com/tools/postman)
- [OpenAPI Makes Easier Integrations](https://dev.to/lornajane/openapi-makes-easier-integrations-5eoj)
- [Evaluate APIs Quickly and Easily with OpenAPI](https://dev.to/nexmodev/evaluate-apis-quickly-and-easily-with-openapi-1g3c-temp-slug-175183)
- [Postman Docs](https://learning.postman.com/docs/getting-started/introduction/)

The post [Announcing the Vonage APIs Postman Collection](https://www.nexmo.com/blog/2020/09/16/announcing-the-vonage-apis-postman-collection) appeared first on [Vonage Developer Blog](https://www.nexmo.com).