Skip to main content
GET
/
v1
/
organizations
/
{organizationId}
/
projects
/
{projectId}
/
assets
Search Assets
curl --request GET \
  --url https://api.example.com/v1/organizations/{organizationId}/projects/{projectId}/assets

​
Path Parameters

​
organizationId
string
required
Organization ID
​
projectId
string
required
Project ID

​
Query Parameters

​
page
number
Page number (default: 1)
​
limit
number
Items per page (default: 20)
​
type
string
Filter by MIME type (e.g., image/jpeg, video/mp4)
​
tag
string
Filter by tag ID (can be repeated for multiple tags)
​
status
string
Filter by status: active or deleted
​
search
string
Search term for name/description
​
sort
string
Sort field and direction (e.g., name:asc, createdAt:desc)
​
from
string
Created date range start (ISO 8601 format)
​
to
string
Created date range end (ISO 8601 format)

​
Response

Returns a paginated list of Asset objects. 
{
  "data": [
    {
      "id": "asset123",
      "name": "hero-image.jpg",
      "type": "image/jpeg",
      "size": 245760,
      "url": "https://cdn.metabind.ai/assets/asset123/hero-image.jpg",
      "status": "active",
      "tags": ["tag1", "tag2"],
      "metadata": {
        "width": 1920,
        "height": 1080
      },
      "createdAt": "2024-03-20T10:00:00Z",
      "updatedAt": "2024-03-21T15:30:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 42,
    "pages": 3
  }
}

​
Code Examples

curl -X GET "https://api.metabind.ai/v1/organizations/org123/projects/proj456/assets?type=image/jpeg&sort=createdAt:desc&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"