Raad Guides
API Reference

Raad API

RESTful API for aerial data collection and site management

Overview

The Raad API provides a RESTful interface for managing your account's campaigns, sites, and collected aerial data. All endpoints return JSON:API formatted responses and follow standard HTTP conventions.

Pagination — List endpoints support pagination using page and per_page query parameters. Default page size is 25, maximum is 100.

Filtering — Most collection endpoints support filtering. Check individual resource documentation for supported filters.

Base URL

All API requests should be made to:

https://app.raad.com/api/v1

Authentication

All API endpoints (except sign-in) require a JWT Bearer token. Obtain a token via the Authentication endpoint, then include it in every request:

HTTP Header
Authorization: Bearer YOUR_JWT_TOKEN

Resources

The API exposes the following core resources:

Users

1 endpoint

  • GET /api/v1/users/{id}

Campaigns

3 endpoints

  • GET /api/v1/campaigns
  • POST /api/v1/campaigns
  • GET /api/v1/campaigns/{id}

Sites

3 endpoints

  • GET /api/v1/sites
  • POST /api/v1/sites
  • GET /api/v1/sites/{id}

Artifacts

2 endpoints

  • GET /api/v1/artifacts
  • GET /api/v1/artifacts/{id}

Data Models

For detailed information about the structure of each resource, see the Data Models reference.