API DOCS
Developer Documentation

AAMOS API Documentation

Build powerful applications with real-time visual intelligence, identity verification, and situational awareness APIs.

Base URL https://api.aamos.ai/v1

Quick Start

Get up and running with the AAMOS API in three steps.

1

Get your API key

Sign up at aamos.ai/signup and create an API key from your dashboard. Keys follow the format ak_live_...

2

Make your first call

Pass your key in the Authorization header on every request.

bash
curl https://api.aamos.ai/v1/vims/objects \
  -H "Authorization: Bearer ak_live_YOUR_KEY"
3

Handle the response

All endpoints return JSON. Check the HTTP status code — 2xx means success, 4xx/5xx means error.

json
{
  "objects": [
    {
      "object_id": "obj_abc123",
      "baseline_count": 3,
      "last_analysis": "2025-01-15T10:30:00Z"
    }
  ]
}

Authentication

All requests must include your API key in the Authorization header.

🔑
Authorization: Bearer ak_live_...
Include this header in every API request. Keep your key secret — never expose it in client-side code.
View full authentication docs →

API Reference

Explore all available AAMOS APIs.


Base URL & Versioning

The current API version is v1. All endpoints are prefixed with:

https://api.aamos.ai/v1
⚠️
API Versioning: We will notify you before introducing breaking changes. Minor additions (new fields, new endpoints) may be added without a version bump.