Put cellular cameras inside your own software.

POST /login
Content-Type: application/json

{ "email": "ops@yourcompany.com", "password": "..." }

// 200
{ "status": 200, "data": { "accessToken": "eyJ...", "refreshToken": "eyJ..." } }

// then, on every other call
Authorization: Bearer eyJ...

{
  "cameraId": "17dbb64d-cfe9-4b3b-84bf-aaf878534af7",
  "IMEI": "861641044933017",
  "cameraName": "South View of Silo",
  "cameraModel": "RangeCam 4G",
  "firmware": "4MR2BOw9807",
  "cameraStatus": "Active",
  "accountId": "987c3263-...",
  "parentId": "25c4e79e-...",
  "lastCommunicationTimestamp": "2022-06-01T16:54:17.989Z",
  "latitude": 39.469438,
  "longitude": -104.874386,
  "heading": 180,
  "csq": 28,            // cellular signal 0-31, 99 = none
  "temperature": 84,    // Fahrenheit
  "batteryCharge": 98,  // percent
  "sdCardUsage": 85     // percent
}

{
  "imageId": "af27afb8-10ab-4e57-8529-dff3a3d34967",
  "url": "https://image.barnowl.tech/.../af27afb8.jpg",
  "thumbUrl": "https://image.barnowl.tech/.../thumb/af27afb8.jpg"
  // timestamp, type and AI hits: see the Image and Hit schemas
}

{
  "cameraId": "17dbb64d-...",      // the group id
  "cameraName": "South Entrance",  // the group name
  "accountId": "987c3263-...",
  "parentId": "25c4e79e-..."
}

# no call for this step

curl -s -X POST https://app.barnowl.tech/api/public/v1/login \
  -H "Content-Type: application/json" \
  -d '{"email":"ops@yourcompany.com","password":"..."}'

curl -s https://app.barnowl.tech/api/public/v1/cameras \
  -H "Authorization: Bearer $TOKEN"

curl -s "https://app.barnowl.tech/api/public/v1/images/$CAMERA_ID?limit=20&offset=0" \
  -H "Authorization: Bearer $TOKEN"

curl -s https://app.barnowl.tech/api/public/v1/trigger/$CAMERA_ID \
  -H "Authorization: Bearer $TOKEN"
# {"status":200,"data":{"triggered":true} }
# the command was sent; the camera answers on its next check-in

# Barn Owl Tech API

> Solar-powered cellular cameras for sites without power or Wi-Fi. Two HTTP APIs.

## Public API (open documentation)
- Base URL: https://app.barnowl.tech/api/public/v1
- Version: 1.0.0. OpenAPI 3 reference: https://app.barnowl.tech/api/docs
- Auth: JWT bearer from POST /login (email, password). Access and refresh tokens.
- Format: JSON. Envelope {status, data}. Errors 401, 403, 404, 409, 422.
- Access: calls require a Barn Owl account on the Business Plan. Docs are public.
- Endpoints (10): POST /login, POST /logout, GET /cameras, GET /cameras/{groupId},
  GET /groups, GET /groups/{groupId}, GET /images/{cameraId}?limit&offset,
  GET /trigger/{cameraId}, POST /create-user, PATCH /owner-reset-password
- Objects: Camera (id, IMEI, model, firmware, status, group, last contact, lat/long,
  heading, cellular signal 0-31, temperature F, battery %, SD %), Group (id field is
  cameraId, name field is cameraName), Image (url, thumbUrl, AI hits with labels
  Animal/Person/Vehicle and bounding boxes), User, Tokens.
- Not supported: account creation, camera settings, webhooks, livestream.
- Rate limits: not published.

## Affiliate API (partner integration, reference under NDA)
- For platforms that run Barn Owl cameras inside their own product under their brand.
  Partner creates end-customer accounts; end customer never sees Barn Owl.
- Version 1.0. REST, JSON, signed requests; webhooks signed the same way.
  Media by signed URL. Livestream by HLS.
- Scope: accounts, cameras (attach by IMEI, control), settings, groups,
  images and detections, livestream, webhooks (thin events).
- Public: this scope. Under NDA: base URL, paths, schemas, signing scheme, payloads, limits.
- Access: discovery call, NDA, technical review, pilot letter (credentials follow).
- Reference partner in production: RanchBot.
- Commercial model: partner buys hardware at cost plus, pays per active camera per year,
  bills own customer.

## Change policy (both APIs)
- Non-breaking: no version change, 14 days notice in the changelog.
- Breaking: new major version, 90-day deprecation window.

## Contact
- Partners: https://barnowl.tech/pages/partners
- Company: Barn Owl Tech, Colorado Springs, Colorado, US