Retrieve a list of folders
List your folders, by name, with pagination. Leave parent_uuid out for every folder you have, send root for the ones at the top of the library, or a folder’s uuid for the ones directly inside it.
GET
/
api
/
v1
/
folders
const response = await fetch("https://api.sudomock.com/api/v1/folders", {
method: "GET",
headers: { "x-api-key": "sm_your_api_key" },
});
const data = await response.json();
console.log(data);
<?php
$ch = curl_init("https://api.sudomock.com/api/v1/folders");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"x-api-key: sm_your_api_key",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
import requests
response = requests.get(
"https://api.sudomock.com/api/v1/folders",
headers={"x-api-key": "sm_your_api_key"},
)
response.raise_for_status()
print(response.json())
require "net/http"
require "uri"
uri = URI("https://api.sudomock.com/api/v1/folders")
request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "sm_your_api_key"
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.body
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://api.sudomock.com/api/v1/folders", nil)
if err != nil {
panic(err)
}
req.Header.Set("x-api-key", "sm_your_api_key")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.sudomock.com/api/v1/folders"))
.header("x-api-key", "sm_your_api_key")
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using System.Net.Http;
using System.Text;
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.sudomock.com/api/v1/folders");
request.Headers.Add("x-api-key", "sm_your_api_key");
var client = new HttpClient();
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
curl -X GET "https://api.sudomock.com/api/v1/folders" \
-H "x-api-key: sm_your_api_key"
{
"success": true,
"data": {
"folders": [
{
"uuid": "c4f1a7d2-3b85-4e60-9a1f-7d2c5e8b4061",
"name": "Frames",
"parent_uuid": "9e3b6c14-27af-4d58-b0e1-5c8a2f9d7340",
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z",
"folder_count": 3,
"psd_mockup_count": 12,
"photo_mockup_count": 4
}
],
"total": 7,
"limit": 20,
"offset": 0
}
}
const response = await fetch("https://api.sudomock.com/api/v1/folders", {
method: "GET",
headers: { "x-api-key": "sm_your_api_key" },
});
const data = await response.json();
console.log(data);
<?php
$ch = curl_init("https://api.sudomock.com/api/v1/folders");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"x-api-key: sm_your_api_key",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
import requests
response = requests.get(
"https://api.sudomock.com/api/v1/folders",
headers={"x-api-key": "sm_your_api_key"},
)
response.raise_for_status()
print(response.json())
require "net/http"
require "uri"
uri = URI("https://api.sudomock.com/api/v1/folders")
request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "sm_your_api_key"
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.body
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://api.sudomock.com/api/v1/folders", nil)
if err != nil {
panic(err)
}
req.Header.Set("x-api-key", "sm_your_api_key")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.sudomock.com/api/v1/folders"))
.header("x-api-key", "sm_your_api_key")
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using System.Net.Http;
using System.Text;
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.sudomock.com/api/v1/folders");
request.Headers.Add("x-api-key", "sm_your_api_key");
var client = new HttpClient();
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
curl -X GET "https://api.sudomock.com/api/v1/folders" \
-H "x-api-key: sm_your_api_key"
{
"success": true,
"data": {
"folders": [
{
"uuid": "c4f1a7d2-3b85-4e60-9a1f-7d2c5e8b4061",
"name": "Frames",
"parent_uuid": "9e3b6c14-27af-4d58-b0e1-5c8a2f9d7340",
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z",
"folder_count": 3,
"psd_mockup_count": 12,
"photo_mockup_count": 4
}
],
"total": 7,
"limit": 20,
"offset": 0
}
}
Authorizations
API key with sm_ prefix. Get your key at https://sudomock.com/dashboard/api-keys
Query Parameters
Folder whose contents to list. root lists the folders at the top of the library. Leave it out to list every folder.
Number of folders to return (1-100)
Required range:
1 <= x <= 100Number of folders to skip
Required range:
x >= 0Was this page helpful?
⌘I
const response = await fetch("https://api.sudomock.com/api/v1/folders", {
method: "GET",
headers: { "x-api-key": "sm_your_api_key" },
});
const data = await response.json();
console.log(data);
<?php
$ch = curl_init("https://api.sudomock.com/api/v1/folders");
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"x-api-key: sm_your_api_key",
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
import requests
response = requests.get(
"https://api.sudomock.com/api/v1/folders",
headers={"x-api-key": "sm_your_api_key"},
)
response.raise_for_status()
print(response.json())
require "net/http"
require "uri"
uri = URI("https://api.sudomock.com/api/v1/folders")
request = Net::HTTP::Get.new(uri)
request["x-api-key"] = "sm_your_api_key"
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
http.request(request)
end
puts response.body
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://api.sudomock.com/api/v1/folders", nil)
if err != nil {
panic(err)
}
req.Header.Set("x-api-key", "sm_your_api_key")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.sudomock.com/api/v1/folders"))
.header("x-api-key", "sm_your_api_key")
.GET()
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
using System.Net.Http;
using System.Text;
var request = new HttpRequestMessage(HttpMethod.Get, "https://api.sudomock.com/api/v1/folders");
request.Headers.Add("x-api-key", "sm_your_api_key");
var client = new HttpClient();
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
curl -X GET "https://api.sudomock.com/api/v1/folders" \
-H "x-api-key: sm_your_api_key"
{
"success": true,
"data": {
"folders": [
{
"uuid": "c4f1a7d2-3b85-4e60-9a1f-7d2c5e8b4061",
"name": "Frames",
"parent_uuid": "9e3b6c14-27af-4d58-b0e1-5c8a2f9d7340",
"created_at": "2026-01-01T00:00:00Z",
"updated_at": "2026-01-01T00:00:00Z",
"folder_count": 3,
"psd_mockup_count": 12,
"photo_mockup_count": 4
}
],
"total": 7,
"limit": 20,
"offset": 0
}
}