API Docs/Endpoints

API Endpoints

Base URL: https://api.elevate.art/v1

Test API Key: test_api_key_123

GET/artworks

Retrieve a paginated list of artworks with optional filters

limitintegerNumber of results per page (default: 20)

offsetintegerNumber of results to skip (default: 0)

artiststringFilter by artist ID

availablebooleanFilter by availability status

min_pricenumberMinimum price filter

max_pricenumberMaximum price filter

sort_bystringSort field: created_at, price, title

sort_orderstringSort order: asc, desc

curl -H "Authorization: Bearer test_api_key_123" \
  "https://api.elevate.art/v1/artworks?limit=10&available=true"

GET/artworks/{id}

Retrieve detailed information about a specific artwork

idstringrequiredArtwork ID (UUID)

curl -H "Authorization: Bearer test_api_key_123" \
  "https://api.elevate.art/v1/artworks/123e4567-e89b-12d3-a456-426614174000"

GET/artists

Retrieve a paginated list of artists

limitintegerNumber of results per page (default: 20)

offsetintegerNumber of results to skip (default: 0)

rolestringFilter by role: artist, collector, tastemaker, institution

curl -H "Authorization: Bearer test_api_key_123" \
  "https://api.elevate.art/v1/artists?role=artist&limit=10"

GET/demo/starry-night

View a complete example of the Elevate Metadata Standard using Van Gogh's Starry Night

ℹ️ No authentication required for demo endpoints

curl "https://api.elevate.art/v1/demo/starry-night"

GET/demo/artist

View a demo artist profile with complete metadata

ℹ️ No authentication required for demo endpoints

curl "https://api.elevate.art/v1/demo/artist"

GET/demo/artworks

View a demo list of artworks with pagination

ℹ️ No authentication required for demo endpoints

limitintegerNumber of results per page (default: 20)

offsetintegerNumber of results to skip (default: 0)

availablebooleanFilter by availability status

curl "https://api.elevate.art/v1/demo/artworks?limit=2&available=true"

Try It Out

Test the API directly in your browser or use the provided curl commands in your terminal.