DocsAPI ReferenceAbout
DocsAPI ReferenceAbout
  1. Assets
  • Overview
  • Getting Started
  • Authentication
  • Permissions
  • Using the Marvia CDN
  • API Reference
    • Users
      • Get a user
      • Delete a user
      • List
      • Create a new user
    • Products
      • List products
    • Locations
      • Update a location
      • Get a location
      • Delete a location
      • List locations
      • Create a new location
    • Groups
      • Get a group
      • Update a group
      • Delete a group
      • List groups
      • Create a new group
    • Uploads
      • Initialize multipart upload
      • Complete multipart upload
    • Assets
      • List assets
        GET
      • Create a new asset
        POST
      • Get asset by UUID
        GET
      • Update an asset
        PATCH
      • Search assets
        GET
  1. Assets

List assets

Production
https://api-v2.getmarvia.com
Production
https://api-v2.getmarvia.com
GET
https://api-v2.getmarvia.com
/v1/assets
Required Permission: read:assets
This endpoint requires an API key with the read:assets permission. Make sure your token was created with this permission during token creation.

Request

Authorization
API Key
Add parameter in header
Authorization
Example:
Authorization: ********************
or
Query Params

Header Params

Responses

🟢200OK
application/json
Success
Body

🟠400Bad Request
🟠401Unauthorized
🔴500Server Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api-v2.getmarvia.com/v1/assets?limit&page&sortBy&sortOrder&filter' \
--header 'Authorization: <api-key>'
Response Response Example
200 - Example 1
{
    "_tag": "Success",
    "data": [
        {
            "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
            "urls": {
                "original": "string",
                "thumbnail": "string",
                "preview": "string",
                "cdnUrl": "string"
            },
            "fileExtension": "string",
            "fileNameOriginal": "string",
            "fileSize": 0,
            "translations": [
                {
                    "locale": "string",
                    "name": "string",
                    "description": "string"
                }
            ],
            "createdAt": "string",
            "editedAt": "string"
        }
    ],
    "pagination": {
        "limit": 1,
        "page": 1,
        "total": 0,
        "pageCount": 0
    }
}
Modified at 2025-09-08 06:20:01
Previous
Complete multipart upload
Next
Create a new asset
Built with