List Media

List media files filtered by optional query payload.

POST

/media/get

Serverhttps://api.medialit.cloud

Authentication

Body

Authentication

Bearer token (JWT)
Or API key in the x-medialit-apikey header

Request body

application/json

pagenumber (float)
limitnumber (float)
accessstringOne of: "public", "private"
groupstring

Responses

200

List retrieved successfully

Array of MediaListItem

mediaIdstring
required
originalFileNamestring
required
mimeTypestring
required
sizenumber (float)
required
accessstring
required
One of: "public", "private"
thumbnailstring
captionstring
groupstring
createdAtstring (date-time)
required

400

Bad Request

errorstring
required

401

Unauthorized

errorstring
required

403

Forbidden

No response body.

500

Internal Server Error

errorstring
required

Request

curl -X POST 'https://api.medialit.cloud/media/get' \
  -H 'Authorization: Bearer $API_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "page": 1,
  "limit": 1,
  "access": "public",
  "group": "string"
}'

const response = await fetch("https://api.medialit.cloud/media/get", {
  method: "POST",
  headers: {
    "Authorization": "Bearer $API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "page": 1,
    "limit": 1,
    "access": "public",
    "group": "string"
  }),
});
const data = await response.json();

import requests

response = requests.request(
    "POST",
    "https://api.medialit.cloud/media/get",
    headers={
        "Authorization": "Bearer $API_TOKEN",
        "Content-Type": "application/json",
    },
    json={
        "page": 1,
        "limit": 1,
        "access": "public",
        "group": "string",
    },
)
data = response.json()

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
	  "page": 1,
	  "limit": 1,
	  "access": "public",
	  "group": "string"
	}`)
	req, _ := http.NewRequest("POST", "https://api.medialit.cloud/media/get", body)
	req.Header.Set("Authorization", "Bearer $API_TOKEN")
	req.Header.Set("Content-Type", "application/json")
	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()
	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

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.medialit.cloud/media/get"))
    .header("Authorization", "Bearer $API_TOKEN")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("""
{
  "page": 1,
  "limit": 1,
  "access": "public",
  "group": "string"
}
"""))
    .build();
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Post, "https://api.medialit.cloud/media/get");
request.Headers.Add("Authorization", "Bearer $API_TOKEN");
request.Content = new StringContent("""
{
  "page": 1,
  "limit": 1,
  "access": "public",
  "group": "string"
}
""", System.Text.Encoding.UTF8, "application/json");
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response

[
  {
    "mediaId": "string",
    "originalFileName": "string",
    "mimeType": "string",
    "size": 0,
    "access": "public",
    "thumbnail": "string",
    "caption": "string",
    "group": "string",
    "createdAt": "2026-01-01T00:00:00Z"
  }
]

{
  "error": "Bad Request"
}

{
  "error": "Unauthorized"
}

{
  "error": "Internal Server Error"
}