Partner API Documentation

1. Get an API key

Apply for a partner account at truefound.pet/bulk. Once approved, you'll receive a unique API key for each store location. Keep keys secret — never embed them in client-side code.

2. Authentication

Send your API key in the Authorization header on every request:

Authorization: Bearer YOUR_API_KEY

3. Create a registration

Call this when a sale completes. Required fields: chip_number, pet.name, pet.species, and owner name, email.

curl -X POST https://yourdomain.com/api/v1/registrations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "chip_number": "985112001234567",
    "pet": {
      "name": "Max",
      "species": "dog",
      "breed": "Golden Retriever",
      "color": "Golden",
      "gender": "male",
      "date_of_birth": "2025-09-01"
    },
    "owner": {
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane@example.com",
      "phone": "5551234567",
      "address_line1": "123 Main St",
      "city": "Northville",
      "state": "MI",
      "zip_code": "48167"
    },
    "implant_date": "2026-06-10",
    "external_reference": "POS-INV-10042"
  }'

Success response (201)

{
  "success": true,
  "registration": {
    "id": "0f3c2a1b-...",
    "confirmation_code": "0F3C2A1B",
    "chip_number": "985112001234567",
    "chip_format": "iso_15digit",
    "is_iso_compliant": true,
    "status": "active",
    "registered_at": "2026-06-11T15:04:05Z",
    "registered_by": "Happy Paws Pet Store #3",
    "external_reference": "POS-INV-10042"
  }
}

Print the confirmation_code on the customer's receipt.

4. Error codes

All errors return JSON: {"success": false, "error": {"code": "...", "message": "..."}}

5. Check a registration

{
  "success": true,
  "registered": true,
  "registration": {
    "id": "0f3c2a1b-...",
    "chip_number": "985112001234567",
    "status": "active",
    "registered_at": "2026-06-11T15:04:05Z",
    "registered_by_you": true
  }
}

Accepted chip formats

• ISO 15-digit numeric (e.g. 985112001234567)
• Legacy 10-digit numeric (HomeAgain and similar)
• AKC Reunite 10-character alphanumeric (begins 0006/0007/0008)
• AVID 9-digit numeric

Spaces and dashes are stripped automatically. Letters are uppercased.