Raad Guides
API Reference

Artifacts

2 endpoints

Overview

Artifacts represent individual pieces of aerial data collected during missions — typically drone photographs, but also videos, point clouds, and processed outputs. Artifacts are scoped to your account and can be filtered by campaign or file type.

GET /api/v1/artifacts Requires Auth

List artifacts for your account.

Parameters

Name In Type Required Description
page query integer No Page number (default: 1)
per_page query integer No Items per page (default: 25, max: 100)
campaign_id query uuid No Filter artifacts by campaign
file_type query string No Filter by file type (e.g. JPEG, RAW, MP4, GeoTIFF)

Responses

200 Artifacts list
Response
{
  "data": [
    {
      "id": "c3d4e5f6-a7b8-9012-cdef-234567890abc",
      "type": "artifact",
      "attributes": {
        "title": "DJI_0042.JPG",
        "fileType": "JPEG",
        "latitude": 30.2672,
        "longitude": -97.7431,
        "altitude": 120.5,
        "relativeAltitude": 100.0,
        "cameraMake": "DJI",
        "cameraModel": "FC3582",
        "droneModel": "Mavic 3 Enterprise",
        "imageWidth": 5280,
        "imageHeight": 3956,
        "photoTakenAt": "2024-03-15T14:32:10.000Z",
        "isProcessed": true,
        "imageUrl": "/rails/active_storage/blobs/.../DJI_0042.JPG",
        "thumbnailUrl": "/rails/active_storage/representations/.../DJI_0042.JPG",
        "createdAt": "2024-03-15T15:00:00.000Z",
        "updatedAt": "2024-03-15T15:05:00.000Z"
      }
    }
  ]
}

GET /api/v1/artifacts/{id} Requires Auth

Retrieve a single artifact with relationships.

Parameters

Name In Type Required Description
id path uuid Yes Artifact UUID

Responses

200 Artifact found
Response
{
  "data": {
    "id": "c3d4e5f6-a7b8-9012-cdef-234567890abc",
    "type": "artifact",
    "attributes": { ... },
    "relationships": {
      "coverageGroup": { "data": { "id": "...", "type": "coverageGroup" } }
    }
  }
}
404 Artifact not found

Artifact Object

The Artifact object contains the following attributes:

Attribute Type Description
id uuid Unique identifier
title string File name or title
fileType string File type (JPEG, RAW, MP4, GeoTIFF, etc.)
latitude decimal GPS latitude where the artifact was captured
longitude decimal GPS longitude where the artifact was captured
altitude decimal Absolute altitude in meters
relativeAltitude decimal Altitude above ground level in meters
cameraMake string Camera manufacturer (e.g. DJI)
cameraModel string Camera model identifier
droneModel string Drone model name
imageWidth integer Image width in pixels
imageHeight integer Image height in pixels
photoTakenAt datetime When the photo was captured (from EXIF)
isProcessed boolean Whether the artifact has been processed
imageUrl string URL to the full-resolution image
thumbnailUrl string URL to a 400x400 thumbnail
createdAt datetime ISO 8601 creation timestamp
updatedAt datetime ISO 8601 last updated timestamp