Media API
nexmo · Company
The Media API can be used to query, download and delete media items such as audio files for use with other Nexmo APIs.
Authentication
Sample Requests
Retrieve information about multiple media items with the ability to search and paginate.
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/?order=ascending&end_time=2020-01-01T14%3A00%3A00.000Z&page_size=50&page_index=1&start_time=2020-01-01T14%3A00%3A00.000Z"
import requests
params = {
"order": "ascending",
"end_time": "2020-01-01T14:00:00.000Z",
"page_size": "50",
"page_index": "1",
"start_time": "2020-01-01T14:00:00.000Z"
}
response = requests.get(
"https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/",
params=params,
)
print(response.json())const url = new URL('https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/');
url.searchParams.set('order', 'ascending');
url.searchParams.set('end_time', '2020-01-01T14:00:00.000Z');
url.searchParams.set('page_size', '50');
url.searchParams.set('page_index', '1');
url.searchParams.set('start_time', '2020-01-01T14:00:00.000Z');
const response = await fetch(url);
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
"net/url"
)
func main() {
baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/")
q := baseURL.Query()
q.Set("order", "ascending")
q.Set("end_time", "2020-01-01T14:00:00.000Z")
q.Set("page_size", "50")
q.Set("page_index", "1")
q.Set("start_time", "2020-01-01T14:00:00.000Z")
baseURL.RawQuery = q.Encode()
targetURL := baseURL.String()
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/")
uri.query = URI.encode_www_form({
"order" => "ascending",
"end_time" => "2020-01-01T14:00:00.000Z",
"page_size" => "50",
"page_index" => "1",
"start_time" => "2020-01-01T14:00:00.000Z"
})
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/?" . http_build_query([
"order" => "ascending",
"end_time" => "2020-01-01T14:00:00.000Z",
"page_size" => "50",
"page_index" => "1",
"start_time" => "2020-01-01T14:00:00.000Z"
]);
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Retrieve information about a single media item
Hover any highlighted part to learn what it does
curl -X GET "https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/:id/info"
import requests
response = requests.get(
"https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/:id/info",
)
print(response.json())const url = 'https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/:id/info'; const response = await fetch(url); const data = await response.json(); console.log(data);
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
targetURL := "https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/:id/info"
req, _ := http.NewRequest("GET", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/:id/info")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Get.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/:id/info";
$opts = ["http" => [
"method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Delete a previously created media item by ID.
Hover any highlighted part to learn what it does
curl -X DELETE "https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/:id"
import requests
response = requests.delete(
"https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/:id",
)
print(response.json())const url = 'https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/:id';
const response = await fetch(url, {
method: 'DELETE',
});
const data = await response.json();
console.log(data);package main
import (
"fmt"
"io"
"net/http"
)
func main() {
targetURL := "https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/:id"
req, _ := http.NewRequest("DELETE", targetURL, nil)
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}require "net/http"
require "json"
uri = URI("https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/:id")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"
req = Net::HTTP::Delete.new(uri)
res = http.request(req)
puts JSON.parse(res.body)<?php
$url = "https://api.apis.guru/v2/specs/nexmo.com/media/1.0.2/:id";
$opts = ["http" => [
"method" => "DELETE",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));Postman Setup Guide
- See official documentation for authentication and setup.
What can you build with Media API?
Media API is a Company API. Developers commonly use company APIs for:
- enriching CRM records with company firmographics
- building lead-generation and prospecting tools
- verifying business identity and registration details
- monitoring competitors and market intelligence
- powering B2B data enrichment pipelines
No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Media API is free to use, making it a low-risk choice to experiment with.
New to APIs? Read our beginner's guide