curl --request GET \
--url https://api.example.com/api/assets{
"data": [
{
"id": "<string>",
"device_asset_id": "<string>",
"device_id": "<string>",
"mime_type": "<string>",
"original_file_name": "<string>",
"file_created_at": "2023-11-07T05:31:56Z",
"file_modified_at": "2023-11-07T05:31:56Z",
"local_datetime": "2023-11-07T05:31:56Z",
"checksum": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"checksum_sha1": "<string>",
"exif": {
"asset_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"make": "<string>",
"model": "<string>",
"orientation": 123,
"modified_datetime": "2023-11-07T05:31:56Z",
"original_datetime": "2023-11-07T05:31:56Z",
"digitized_datetime": "2023-11-07T05:31:56Z",
"lens_model": "<string>",
"f_number": 123,
"focal_length": 123,
"iso": 123,
"exposure_time": 123,
"exposure_bias": 123,
"latitude": 123,
"longitude": 123,
"altitude": 123,
"city": "<string>",
"state": "<string>",
"country": "<string>",
"description": "<string>",
"fps": 123,
"live_photo_cid": "<string>",
"projection_type": "<string>",
"profile_description": "<string>",
"auto_stack_id": "<string>",
"rating": 123
},
"metrics": {},
"download_url": "<string>",
"thumbnail_url": "<string>",
"asset_urls": {},
"description": "<string>",
"faces": [
{
"id": "<string>",
"asset_id": "<string>",
"bounding_box": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"person_id": "<string>",
"timestamp_ms": 123,
"thumbnail_url": "<string>",
"asset_urls": {}
}
],
"people": [
{
"id": "<string>",
"is_hidden": true,
"is_favorite": true,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"birth_date": "2023-12-25",
"asset_count": 123,
"thumbnail_face_id": "<string>",
"thumbnail_face_url": "<string>",
"asset_urls": {}
}
],
"width": 0,
"height": 0,
"file_size_bytes": 0
}
],
"has_more": true
}Retrieves a paginated list of assets from the specified library, optionally filtered by album, person, or specific asset IDs. Asset data includes metrics, EXIF data, faces, and people. Assets are ordered by local creation time, descending.
curl --request GET \
--url https://api.example.com/api/assets{
"data": [
{
"id": "<string>",
"device_asset_id": "<string>",
"device_id": "<string>",
"mime_type": "<string>",
"original_file_name": "<string>",
"file_created_at": "2023-11-07T05:31:56Z",
"file_modified_at": "2023-11-07T05:31:56Z",
"local_datetime": "2023-11-07T05:31:56Z",
"checksum": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"checksum_sha1": "<string>",
"exif": {
"asset_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"make": "<string>",
"model": "<string>",
"orientation": 123,
"modified_datetime": "2023-11-07T05:31:56Z",
"original_datetime": "2023-11-07T05:31:56Z",
"digitized_datetime": "2023-11-07T05:31:56Z",
"lens_model": "<string>",
"f_number": 123,
"focal_length": 123,
"iso": 123,
"exposure_time": 123,
"exposure_bias": 123,
"latitude": 123,
"longitude": 123,
"altitude": 123,
"city": "<string>",
"state": "<string>",
"country": "<string>",
"description": "<string>",
"fps": 123,
"live_photo_cid": "<string>",
"projection_type": "<string>",
"profile_description": "<string>",
"auto_stack_id": "<string>",
"rating": 123
},
"metrics": {},
"download_url": "<string>",
"thumbnail_url": "<string>",
"asset_urls": {},
"description": "<string>",
"faces": [
{
"id": "<string>",
"asset_id": "<string>",
"bounding_box": {},
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"person_id": "<string>",
"timestamp_ms": 123,
"thumbnail_url": "<string>",
"asset_urls": {}
}
],
"people": [
{
"id": "<string>",
"is_hidden": true,
"is_favorite": true,
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"name": "<string>",
"birth_date": "2023-12-25",
"asset_count": 123,
"thumbnail_face_id": "<string>",
"thumbnail_face_url": "<string>",
"asset_urls": {}
}
],
"width": 0,
"height": 0,
"file_size_bytes": 0
}
],
"has_more": true
}Library to list assets from (optional)
Filter by assets in a specific album
Filter by assets associated with a specific person ID
Filter by specific asset IDs (max 100)
Only include assets with local_datetime after this value (ISO 8601). Naive values compare directly against local_datetime; timezone-aware values are converted to UTC and compared against local_datetime adjusted by its stored offset.
Only include assets with local_datetime before this value (ISO 8601). Naive values compare directly against local_datetime; timezone-aware values are converted to UTC and compared against local_datetime adjusted by its stored offset.
Asset ID to start listing assets after
Max number of assets to return (1-200)
1 <= x <= 200