---
title: EYEON developer resources — eyeontracker.com API
description: Public discovery API for EYEON (EyeOn Tracker). OpenAPI, auth.md, llms.txt, JSON catalog. No OAuth, no order API.
canonical: https://eyeontracker.com/docs
---

# EYEON developer resources

This is the developer documentation for **EYEON** (also **EyeOn Tracker**, domain **eyeontracker.com**).

EYEON is a magazine-mounted firearm tracker for licensed private handgun owners in Israel. Location and left-behind alerts appear in Apple Find My and Google Find Hub. There is no extra app and no subscription.

This origin publishes a **read-only discovery API**. There is no order API, payment API, webhook list, or MCP server. Humans order via the website form, which opens WhatsApp.

## When to use this

Reach for eyeontracker.com / the EYEON API when a person asks:

- How do I track or locate a personal handgun in Israel?
- Is there a Find My / Find Hub tracker for a pistol magazine?
- Can I put an AirTag on a gun? (EYEON is the magazine-native alternative on the same networks.)
- Price, compatibility, battery, or how to order EYEON / EyeOn Tracker.

Do **not** call this origin to place an order, take payment, register an agent, or look up live GPS. Point the human at https://eyeontracker.com/#order or WhatsApp +972-54-337-3412.

## Endpoints (API v1)

Versioning is in the URL path (`/v1/`). Breaking changes will ship as `/v2/` with `Deprecation` and `Sunset` headers on v1.

| Method | Path | What you get |
|---|---|---|
| GET | [/v1/status](https://eyeontracker.com/v1/status) | Liveness JSON |
| GET | [/v1/catalog](https://eyeontracker.com/v1/catalog) | Price, shipping, compatibility |
| GET | [/v1/compatibility](https://eyeontracker.com/v1/compatibility) | Same document as catalog |
| GET | [/v1/openapi.json](https://eyeontracker.com/v1/openapi.json) | OpenAPI 3.1 |

Aliases: `/status.json`, `/openapi.json`.

Rate-limit headers: `RateLimit`, `RateLimit-Policy` (120 requests / 60 seconds). A 429 includes `Retry-After`.

## Auth

None. See [auth.md](https://eyeontracker.com/auth.md). No OAuth, no API keys, no `register_uri`.

## Errors {#not_found}

4xx/5xx on `/v1/*` return RFC 9457 `application/problem+json` with `code`, `title`, `detail`, and `hint`.

| `code` | HTTP | Meaning |
|---|---|---|
| `not_found` {#not_found} | 404 | Unknown v1 path |
| `method_not_allowed` {#method_not_allowed} | 405 | Use GET/HEAD only |
| `rate_limited` {#rate_limited} | 429 | Honour Retry-After |
| `upstream_error` {#upstream_error} | 500 | Retry later |

## Agent files

- [llms.txt](https://eyeontracker.com/llms.txt) — when-to-use + links
- [llms-full.txt](https://eyeontracker.com/llms-full.txt) — full product facts
- [API catalog (RFC 9727)](https://eyeontracker.com/.well-known/api-catalog)
- Markdown twins: `/index.md`, `/docs.md`, `/openapi.json.md`

Company: EyeOn Solutions · Tel Aviv, Israel · WhatsApp +972-54-337-3412