API-first

Developers & partner API

ForeverMicro exposes a stable, versioned REST API so vets, shelters, universal-lookup services and other registries can integrate. Read-only lookups are public and never expose owner information.

Base URL	`https://forevermicro.org/api/v1`
Format	`application/json`
Auth	None for public lookups (privacy relay protects owners)
Rate limit	120 requests / minute per client
CORS	Enabled for read-only `GET` lookups
OpenAPI spec	`/openapi/v1.json`
Health	`/health`

Microchip lookup

The universal-lookup contract: confirms whether ForeverMicro holds a chip and returns recovery routing. Accepts 9/10/15-character formats.

GET https://forevermicro.org/api/v1/microchips/985112000123456/lookup

{
  "microchip": "985112000123456",
  "found": true,
  "registry": "ForeverMicro",
  "lookupProvider": "forevermicro.org",
  "manufacturerPrefix": "985",
  "foreverId": "FM-8H4K-92LQ",
  "status": "lost",
  "recoveryUrl": "https://forevermicro.org/p/FM-8H4K-92LQ",
  "queriedAtUtc": "2026-08-16T00:00:00Z"
}

When a chip isn't held here, found is false — a universal lookup can then route to other registries. Owner details are never returned; the recoveryUrl lets a finder or vet contact the family through the privacy relay.

Other endpoints

GET /api/v1/pets/{foreverId} — public safety profile
GET /api/v1/lost-pets — active lost-pet incidents
POST /api/v1/lost-pets/{slug}/sightings — report a sighting (no account)

Integrating a universal lookup, shelter scanner, or veterinary system? Talk to us — we're building ForeverMicro to participate in the broader pet-recovery infrastructure.