---
title: PawsitivID Partner API — Pet Identity, Lost & Found, Records
description: "PawsitivID’s partner APIs give pet insurers, vet software, registries, and pet-tech apps five services on one pet record: biometric identity, lost-and-found recovery, document extraction, an AI pet assistant, and municipal licensing. For an insurer that means identity at bind and at claim, invoices as structured data, and engagement between claims, with usage-based pricing."
type: static
date_modified: 2026-09-07
canonical: https://www.pawsitivid.com/partners
language: en
---

Last updated: 2026-09-07

# Pet identification APIs. Built for insurers.

PawsitivID’s partner APIs give pet insurers, vet software, registries, and pet-tech apps five services on one pet record: biometric identity, lost-and-found recovery, document extraction, an AI pet assistant, and municipal licensing. For an insurer that means identity at bind and at claim, invoices as structured data, and engagement between claims, with usage-based pricing.

**Verify the pet on every claim. Turn vet invoices into claim lines. Give members a reason to open your app between claims. Under your brand, inside your stack.** Also built into vet software, shelter systems, and microchip registries.

What you can embed: biometric pet ID, the Lost & Found network, document extraction, an AI pet assistant, and municipal licensing. Every match is reviewed before the owner is told. US-hosted, encrypted in transit and at rest. Sandbox access within 3 business days. Security packet and DPA on request. A city, shelter, or animal control agency? See [PawsitivID for Organizations](https://www.pawsitivid.com/platform).

## What does it do for an insurer?

Four jobs, each tied to a number your book already tracks. We do not publish outcome figures we have not measured with a partner; the pilot measures them, and you keep the results.

### Identity at bind and at claim

Enroll the pet when the policy starts. At claim time, one photo confirms the pet on the invoice is the pet on the policy. Disputes about which animal was treated, and when, get an answer instead of an argument. The pilot measures: verified-pet rate at bind, claims flagged for identity review, leakage on substituted pets. APIs: PawsitivID.

### Invoices in, claim lines out

Members photograph the vet invoice in your app. You get line items, procedure descriptions, clinic, dates, and totals as structured fields with confidence scores, ready for your rules engine. Low-confidence fields route to a human, the rest go straight through. The pilot measures: straight-through processing rate, claim cycle time, loss adjustment expense per claim. APIs: Records, PawsitivID.

### A reason to open your app between claims

Most members touch an insurer once a year. Lost-and-found alerts, vaccine reminders from extracted records, and an assistant that knows their pet give the policy a daily-use surface, under your brand. The pilot measures: monthly active members, lapse rate at renewal, contact-center deflection. APIs: Lost & Found, Avva Assistant.

### A yearly compliance moment

Where the city runs on PawsitivID, members license their pet inside your app. You earn a share of each license, and the renewal date becomes a touchpoint you control. The pilot measures: licenses issued through your app, renewal-moment conversions. APIs: Licensing.

## What can you embed?

Five APIs on one pet record. Start with PawsitivID and add modules as your roadmap needs them. Every module reads and writes the same profile, so nothing is entered twice. This is the v1 surface for launch partners; the OpenAPI spec ships with sandbox access.

### PawsitivID API (identity, foundation)

A permanent biometric identity for every pet in your app. Four photos from any phone become a PawsitivID that never changes, plus a one-to-one check that answers “is this the same pet?” at bind and at claim.

- Four-angle photo enrollment with quality scoring
- Permanent PawsitivID alongside microchip and tag numbers
- 1:1 verification: does this photo match this pet?
- Verified vs provisional enrollment, so claim checks only trust guided captures
- Breed, color, and species reference data
- Webhooks for every profile change

Endpoints: `POST /v1/pets`, `POST /v1/pets/{id}/photos`, `POST /v1/pets/{id}/verify`, `GET /v1/pets/{id}`. Billed per active pet, per month. Moves: pet substitution, disputed pre-existing conditions, claims leakage.

### Lost & Found API (requires PawsitivID)

Open a case with one call. Anyone who finds the pet reports it from your app, the PawsitivID app, pawsitivid.com, or the portal shelters and animal control use. A reviewed match reaches you as a webhook, inside your app, not on a public bulletin board.

- 1:N matching against every pet in the PawsitivID network
- Every candidate is reviewed before the owner is told
- match.candidate, match.confirmed, and case.resolved webhooks
- Finder contact released only after the owner confirms
- Embeddable found-pet widget for your app or site

Endpoints: `POST /v1/lost-cases`, `POST /v1/found-reports`, `POST /v1/matches/{id}/decision`, `PATCH /v1/lost-cases/{id}`. Billed per protected pet, per month. No per-report or per-match fees. Moves: retention, member engagement, a non-claim reason to open your app.

### Records API (works standalone)

Vaccination certificates, vet invoices, license papers. Send a photo or PDF and get structured fields back: rabies date, clinic, line items, each tagged with the page it came from. Works on documents the owner uploads in your app: no PIMS connection, no clinic opt-in.

- Extraction with per-field confidence
- Source-page attribution on every fact
- Review state so your staff can accept or correct
- Records summary per pet: what is current, what expired
- Works on phone photos, scans, and PDFs

Endpoints: `POST /v1/documents/extract`, `POST /v1/pets/{id}/documents`, `GET /v1/documents/{id}`, `GET /v1/pets/{id}/records/summary`. Billed per document. Moves: straight-through processing rate, claim cycle time, loss adjustment expense.

### Avva Assistant API (works standalone)

A pet-aware assistant your members talk to about their own pet: health questions, behavior, records, what to do next. Grounded on the profile and documents you hold, under your brand name. Routine questions get answered before they become calls.

- Streaming conversations over WebSocket
- Grounded on the pet’s profile, records, and license status
- Voice transcription and file parsing
- Feedback endpoint for every answer
- Your assistant name and tone, our model and safety rails

Endpoints: `WS /v1/chat/conversation`, `GET /v1/chat/pets/{id}/history`, `POST /v1/chat/transcribe`, `POST /v1/chat/messages/{id}/feedback`. Billed per conversation. Moves: contact-center deflection, member engagement between claims.

### Licensing API (requires PawsitivID)

Resolve the jurisdiction from a ZIP code, quote the fee, issue or renew the city license, and return the PDF. Where a city runs on PawsitivID, your users license their pet without leaving your app. For an insurer, a compliance touchpoint members value and a yearly renewal moment you can act on.

- Jurisdiction match from ZIP code
- Fee quote from the city’s own configuration
- Issue, renew, and download the license PDF
- Local authority tag assignment where the city uses tags
- Renewal reminders through your channel

Endpoints: `POST /v1/licenses/jurisdictions/match`, `GET /v1/licenses/pricing`, `POST /v1/pets/{id}/license`, `GET /v1/licenses/{id}/pdf`. No API fee. Partners earn a share of each license issued. Moves: a yearly renewal touchpoint, revenue share on every license.

## How does a pet insurer ship it?

Pre-bind to renewal, each stage maps to one or two APIs. No core system is replaced; anything with a REST client can call it.

1. **Enrollment.** Capture four photos at bind. Get a PawsitivID and a biometric signature. (PawsitivID)
2. **Policy.** Lost-pet button, found-pet widget, and Avva live in your member app. (Lost & Found, Avva)
3. **Claim.** Invoice photo becomes claim lines. One photo confirms the pet is the pet. (Records, PawsitivID)
4. **Renewal.** License renewal and vaccine expiry become touchpoints you control. (Licensing, Records)

Three ways in, by effort. Estimates for a partner team with a REST client and one mobile engineer; the pilot agreement fixes the dates.

- **Web widget, days.** The found-pet wizard from pawsitivid.com, in your colors, on your domain.
- **REST and webhooks, 2 to 6 weeks.** Enrollment, verification, extraction, and lost cases wired into your own screens.
- **Mobile capture SDK, 6 to 12 weeks.** Guided four-angle capture in your app. Flutter in private beta; native wrappers on the roadmap.

For your engineers, the lost-pet journey in two calls and one webhook:

### Step 1: Enroll at onboarding

When a policy starts, your app captures four photos with the SDK or your own camera flow. One call returns a PawsitivID and a biometric signature. Existing members enroll from a nudge in your app.

### Step 2: The member marks the pet lost

One tap in your app opens a case with the last-seen location. Nothing to install, nothing to explain.

### Step 3: The network searches

Finders report from your app, the PawsitivID app, pawsitivid.com, or the portal shelters and animal control use. Every report is matched against open cases.

### Step 4: You get the webhook

A reviewer checks the candidate. Then match.candidate arrives with the sighting location, photos, and a confidence score. You notify the member in your own push channel.

### Step 5: The member confirms. Contact is released.

The member confirms in your app, the finder’s contact details are released, and case.resolved closes the loop for your records.

The claim-time journey, which is where an insurer starts: `POST /v1/pets/{id}/verify` with the claim photo returns a match decision, a score, and whether the enrollment was verified or provisional. `POST /v1/documents/extract` with the invoice photo returns the clinic, service date, total, and line items with a confidence score on each, plus a needs_review list for anything below threshold.

## Why does the network matter?

A public lost-pet database is where an owner goes after a loss. This enrolls the pet at bind, matches inside your app, and fires events you can act on. Pets enrolled through your app join the same registry as every pet in the PawsitivID app, and four finder routes feed one queue.

- Your app: the SDK’s found-pet widget, under your brand, for your own users.
- The PawsitivID app: guests report a found pet without an account. Owners get their own alerts.
- pawsitivid.com: a public web form anyone can use from a search result or a QR code.
- Shelters and animal control: officers upload intake photos from the portal cities already run on.

Identification accuracy is 99.7% on registration-quality photos across nose print, fur pattern, and facial structure; field accuracy tracks photo quality, and the pilot reports yours. In the [ASPCA national lost-pet survey](https://www.aspca.org/about-us/press-releases/how-many-pets-are-lost-how-many-find-their-way-home-aspca-survey-has-answers), 15% of owners lost a dog or cat in a five-year span. 93% of lost dogs were recovered, but only 74% of cats. Cats are where recovery fails today. Microchip recovery depends on an up-to-date registry, per the [AVMA](https://www.avma.org/resources-tools/pet-owners/petcare/microchips-reunite-pets-families). A biometric ID has no registry to go stale.

Alongside the chip, not instead of it. In a study of 7,704 microchipped animals entering 53 US shelters ([Lord et al., JAVMA 2009](https://doi.org/10.2460/javma.235.2.160)), owners were found for 74.1% of stray dogs but only 63.5% of stray cats. Where owners could not be reached, 35.4% of cases came down to an incorrect or disconnected phone number, and 41.9% of chips checked against a registry were not registered at all.

| Method | What the finder needs | What the owner must maintain |
|---|---|---|
| Microchip | A scanner and a registry with current contact details | Registry kept up to date |
| Collar tag or QR | The collar still on the pet | A current tag |
| PawsitivID | A phone photo from any angle | Nothing; the face is the record |

## Who is the partner API for?

Any product that already holds a pet record and wants it to do more. Insurers first, because they hold the most records and carry the cost when a pet is lost. Each of the others gets its own vocabulary and its own integration path.

### Pet insurers (primary)

Turn a policy into an app people open. Enroll every insured pet with a biometric ID at bind. Confirm the pet on a claim is the pet on the policy. Turn vet invoices into structured claim lines. Give members lost-pet recovery and an assistant between claims. Under your brand, in your stack, on your paper.

- Identity check at bind and at claim
- Invoice and vaccination extraction for claims intake
- Recovery as a benefit line, not a reimbursement
- Non-exclusive by default, no minimum participation

7.6 million pets were insured in North America at the end of 2025, up 8.5% in a year, per [NAPHIA industry data](https://naphia.org/industry-data/). Every one of them is a record that could carry a PawsitivID.

### Vet software and shelter systems

A biometric ID on the patient record. One call when a photo set is captured adds a PawsitivID to the record. Verification status and match alerts write back. Nightly batch or real time. We support your standard integration spec and list in your directory.

### Microchip registries

A photo when there is no scanner. Enroll by chip number (ISO 11784/11785, any brand) or your enrollment source ID, with CSV batch upload for backfill. A finder without a scanner still gets a match, and the alert goes to the registry’s existing owner contact.

### Pet-tech and retail apps

A real identity behind every pet profile. GPS collars, feeders, marketplaces. Give every pet on your platform a PawsitivID and lost-and-found without training a matching model.

### Pet screening, housing, and boarding

Verify the animal, not the paperwork. Confirm the pet in front of you is the pet on file, and read vaccination status straight from the certificate.

## What does it cost?

One meter per API, in your own units: per insured pet per month, per claim document, per conversation. A monthly allowance covers support and the sandbox; there is no setup fee. Volume rates step down automatically, with no overage penalties, no minimum participation, and no exclusivity unless you ask for it.

### Plans

- **Sandbox (free).** Test keys for all five APIs, 50 sample enrollments, sample documents, replayable webhooks. Never expires. No production traffic.
- **Launch ($250 per month).** Production keys for a first integration or a 90-day pilot with agreed KPIs. The fee is a usage allowance, not a platform charge: 500 protected pets, 250 documents, and 250 conversations included. No setup fee, no contract, cancel monthly. Launch rates beyond the allowance. Email support, 99.5% uptime target.
- **Scale (from $1,500 per month, annual commitment).** Scale rates on every meter from the first pet. 99.9% SLA with credits. Priority support and a shared channel. SSO and audit log.
- **Enterprise (custom).** For books of 100,000 pets and up, white-label programs, or MGAs and program administrators. White-label widget and assistant. Custom licensing revenue share; category or state exclusivity. DPA, custom retention, security review. Dedicated integration engineer.

### Usage rates by API

| API | Unit | Launch | Scale | Enterprise |
|---|---|---|---|---|
| PawsitivID (1:1 verification included) | Active pet, per month | $0.40 | $0.25 | Custom |
| Lost & Found (reports, matches, reunions not metered) | Protected pet, per month | + $0.35 | + $0.25 | Custom |
| Records | Document, up to 10 pages | $0.25 | $0.15 | Custom |
| Avva Assistant | Conversation, up to 25 messages | $0.20 | $0.12 | Custom |
| Licensing (you earn a share of each license) | License issued | No fee | No fee | Custom |

An active pet has an enrolled biometric signature in the billing month. A protected pet is an active pet with Lost & Found enabled, so a fully covered pet is $0.75 PMPM at Launch and $0.50 PMPM at Scale. Worked example: a book of 10,000 insured pets, fully covered on Scale, is $5,000 a month before documents and conversations. Finders never pay: reporting a found pet is free on every route. Indicative rates for launch partners. The pilot agreement sets the final figures.

## How is it delivered?

Pick the surface that fits your stack. Most partners ship the widget first and the REST API for everything else. We list what exists today, not what is planned.

- **REST and webhooks.** Versioned under /v1 with an OpenAPI spec and a Postman collection. Idempotency keys on writes, signed webhooks that retry.
- **Web widget.** The same found-pet wizard that runs at pawsitivid.com/found-a-pet, embeddable with your colors and logo, on your domain.
- **Mobile capture SDK.** Guided four-angle capture with quality checks. Flutter in private beta; iOS and Android wrappers on the roadmap. Until then, your own camera flow can post photos to the API.
- **Sandbox.** Seeded test pets, sample documents, staged lost-pet matches, replayable webhooks. Same rate limits as production. Never expires.

### Request sandbox access

Access is reviewed, not self-serve, so that every key on the network belongs to a named partner. The gate is short and we say what is behind it.

1. **Request access.** Tell us who you are and what you plan to build. We review requests within 3 business days.
2. **Build in the sandbox.** Approved partners receive sandbox credentials, the OpenAPI spec, a Postman collection, and 25 seeded test pets the same day.
3. **Integration review, then production keys.** A 30-minute walkthrough of your integration end to end. Production keys are issued after it, with the plan you chose.

What we do not offer: custom endpoints built on request, raw access to another partner’s pets, keys without a named technical contact.

### What we commit to

- Your members’ data stays yours. Export and delete on request. We never resell it.
- Member consent is captured at enrollment and named in your privacy notice.
- Finder contact is released only after the owner confirms a match.
- No attribution required. Your brand, your UI.
- Encrypted in transit and at rest.
- Hosted in the United States.
- Per-partner keys with scoped permissions and rate limits; a key sees only its own tenant.
- Every match decision is logged with who made it and when.
- Photos are retained while the pet is enrolled and removed with the profile on delete.

Security documentation and a data processing agreement are available during evaluation. We do not hold a SOC 2 report today and will say when we do. Subprocessors: AWS, Modal, MongoDB, Google (Gemini), Anthropic, OpenAI, Auth0, Stripe, Twilio, Resend, Mapbox, Sentry. The full list, with regions, is in the security packet.

## What does the v1 contract look like?

The commitments the sandbox ships with. The full reference is the OpenAPI spec you receive with sandbox access.

- **Auth.** OAuth 2.0 client credentials for server-to-server. Short-lived scoped tokens, minted by your backend, for the web widget and mobile capture.
- **Environments.** api.pawsitivid.com/v1 (production) and sandbox.api.pawsitivid.com/v1 (seeded test pets and documents, same rate limits as production).
- **Rate limits.** 300 requests per minute per key, burst to 600. Over the limit returns 429 with Retry-After; every response carries x-ratelimit-limit, -remaining, -reset.
- **Pagination and idempotency.** Cursor pagination, 25 per page by default, 200 max. Idempotency-Key header on every POST; replays return the original result.
- **Versioning.** Version in the path. Breaking changes ship as a new version with 12 months of notice. Non-breaking additions are announced in the changelog.
- **Data scoping.** A partner key reads and writes only that partner’s pets, documents, and cases. Matching runs across the network; owner details never cross tenants.
- **Deliverables.** OpenAPI spec, Postman collection, web widget, Flutter capture SDK (private beta). No native SDKs yet; we say so rather than list them.
- **Status and changelog.** Public status page with API, webhook delivery, and sandbox components, plus a dated changelog, from the day production keys are issued.

Webhook events: pet.enrolled, pet.verified, pet.verification_failed, match.candidate, match.confirmed, match.rejected, case.resolved, record.extracted, record.needs_review, license.issued, license.expiring. Payloads carry IDs plus a summary, never the full record. Signed with HMAC-SHA256, retried with exponential backoff for 24 hours, one idempotency key per delivery.

## What do partners ask before they sign?

### Do our members need the PawsitivID app?

No. Your members stay in your app. Enrollment, lost reports, notifications, and confirmation all run through your interface using the API and widget. The PawsitivID app, website, and organization portal are extra places a finder can report a pet, which is what makes the network useful to you.

### Who owns the member relationship and the data?

You do. Pets enrolled through your app live in your tenant. You own the profile, the photos, the documents, and the owner relationship. Other partners cannot read them. The biometric signature is searchable by finders across the network so a match can happen anywhere, but owner details are released only through the flow you control.

### What member consent is needed, and what do you share back?

At enrollment, the member agrees to a notice you show, which names PawsitivID as the identity and matching provider. We store the photos, the biometric signature, and the documents they upload. We share back to you: the PawsitivID, verification results, match events, and extracted fields. We do not sell or share member data with anyone else.

### Do we need a license or a filing to use this?

No. None of the APIs quote, sell, or bind insurance, so nothing here touches your rate filings. The Licensing API handles municipal pet licenses, which are city permits, not insurance products.

### Is it exclusive?

Non-exclusive by default, with no minimum participation. Category or state exclusivity is available on Enterprise terms.

### How do you handle a false match or a disputed identity?

Every candidate is reviewed before it reaches you: by a human by default, or auto-approved above a confidence threshold agreed with you. The match arrives with its confidence score, and only the member’s confirmation releases the finder’s contact. Every decision is logged with who made it and when, so a dispute has a record to point at.

### There are free lost-pet databases. Why pay for this?

A public database is where an owner goes after a loss. This enrolls the pet at bind, matches inside your app, fires webhooks you can act on, and covers four finder routes including the portal shelters and animal control use. You pay per protected pet, not per report, so the incentive is to report more, not less.

### What does a pilot look like, and how is success measured?

Sandbox first, then a 90-day production pilot on the Launch plan with KPIs agreed up front: verified-pet rate at bind, straight-through rate and cycle time on extracted invoices, monthly active members, and reunions. We publish the results to you at the end, whatever they say.

### Can we white-label the assistant and the found-pet widget?

Yes. The assistant answers under the name and tone you configure. The found-pet widget takes your colors and logo. No attribution is required anywhere in your UI. PawsitivID is named in the privacy notice at enrollment, which members need to see.

### Can we use Records or Avva without enrolling pets?

Yes. Both work without a PawsitivID. Records extracts any document you send. Avva answers with whatever context you pass. Both get better with a profile to ground on, which is why most partners start with PawsitivID.

### Where is data hosted, and can we delete a member’s biometric record?

In the United States, encrypted in transit and at rest. A delete call removes the profile, photos, signature, and documents; a data processing agreement covers retention and export terms.

### What photos does enrollment need?

Four clear photos: front, left, right, back. The capture flow guides each shot and scores it, so most enrollments finish in under a minute. Photos can also be added later; the signature is rebuilt from the best six on file, so a puppy that grows or a dog that gets groomed stays matchable.

### Can we enroll from photos we already have, without the guided capture?

Yes, with a caveat. Photos posted from your own flow create a provisional enrollment: matchable for lost-and-found, not usable for 1:1 claim verification. A guided capture through the SDK or widget upgrades it to verified. That split is deliberate: an uploaded photo is an enrollment-fraud vector, and a claims team needs to know which pets were captured live.

### How accurate is it, and how do you measure it?

99.7% is the published identification benchmark on registration-quality photos across nose print, fur pattern, and facial structure. It is not a field number. Every candidate match carries a confidence score, thresholds are calibrated on an internal evaluation set, and a reviewer sees the candidate before you do. We share the evaluation summary during your review, and the pilot reports true-accept and false-accept rates on your own book.

### Does it work for cats?

Yes. Cats enroll with the same four photos and match on facial geometry, nose print, and coat pattern. Indoor cats are the strongest case: they rarely wear collars and a neighbor cannot scan a chip.

### What if a member already uses the PawsitivID app?

With the member’s consent, the existing pet links to your tenant. One PawsitivID, two surfaces: they keep their app, you get the same verification and match events. Nothing is duplicated.

### What do we see if a found pet matches another partner’s pet?

Nothing. The finder report is routed to the tenant that owns the pet, and that partner’s flow takes it from there. Your key only ever sees your own pets, cases, and documents.

## Book an integration review

Thirty minutes with a product lead and an engineer. We map your use case to the bundles, agree pilot KPIs, and issue sandbox keys within three business days. Email [PetsRule@PawsitivLife.com](mailto:PetsRule@PawsitivLife.com?subject=PawsitivID%20partner%20API%3A%20integration%20review) or request the security packet first.