Skip to content
Remembrance DirectoryBusiness login
Developers

Remembrance API

Connect your own platform to Remembrance: retrieve paw and nose prints, look up folders and memorials by Pet ID, and pull leads from your website widgets.

This page is for whoever looks after your website or software. If that is not you, send them this link. Prefer to work by chat? Connect your AI assistant instead.

Get an API key

API keys are created in the Remembrance portal under Integrations. Owners and Admins of a provider account can create a key, give it a label, set its allowed origins and revoke it. Keep your key private: anyone with it can read your data.

Sign in to the portal

Authentication

Send your API key in the Authorization header of every request, as a Bearer token:

Authorization: Bearer rs_live_your_key_here

Base URL

https://app.remembrancepets.com/api/v1

Endpoints

Remembrance API endpoints
EndpointWhat it returns
GET /leadsList the leads captured by your Quality of Life and Pre-planner widgets, newest first. See the field reference below.
GET /printsList final, exported prints (the default). Supports the filters below.
GET /prints/{id}One print with its download links. Returns any print, whatever its type.
GET /foldersList all folders.
GET /folders/{id}One folder. {id} is the folder UUID or the folder name (the Pet ID). Includes memorials: the stars, memorial trees and ocean memorials with the same Pet ID, each with registration_number, kind (star, tree or ocean), pet_name and memorial_url.
GET /folders/{id}/printsFinal prints in one folder. Supports the same filters as /prints.

Leads

GET /leads returns the leads captured by your embeddable Quality of Life and Pre-planner widgets, newest first. Query parameters:

Query parameters for GET /leads
ParameterMeaning
tool_typeqol or preplanner.
statusnew, contacted or converted.
sinceAn ISO timestamp. Only leads created after it, for syncing just what is new.
limit100 by default, 500 at most.
offsetHow many to skip, for the next page.

Example

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://app.remembrancepets.com/api/v1/leads?tool_type=qol&since=2026-06-01T00:00:00Z"

# Returns:
# { "data": [ { ...the fields below... } ],
#   "meta": { "count", "limit", "offset", "has_more", "next_offset" } }

Lead field reference

Each lead in GET /leads, and the data object in every lead webhook, has these fields.

Lead field reference
FieldTypeDescription
iduuidUnique lead id.
tool_typeqol | preplannerWhich widget captured the lead.
first_namestringLead's first name.
last_namestringLead's last name.
emailstringContact email.
phonestring | nullPhone, if provided.
whatsappstring | nullWhatsApp number, if provided.
pet_namestring | nullPet's name.
pet_speciesstring | nulldog or cat, if provided.
pet_ageint | nullAge in years.
pet_weightnumber | nullWeight in lbs.
pet_breedstring | nullBreed, if provided.
scoreintQuality of Life score, 0 to 20 (lower is better).
statusnew | contacted | convertedWhere the lead is in your follow-up.
activatedboolTrue once the lead activated an app account.
notesstring | nullThe owner's note on the lead.
entry_dataobjectFull assessment answers.
created_atstring (ISO)When the lead was captured.

Filters for /prints and /folders/{id}/prints

Filters for /prints and /folders/{id}/prints
ParameterMeaning
folder={id}Only one folder. Accepts the folder UUID or name (Pet ID). Names match ignoring surrounding spaces and letter case. An unknown folder returns 404; a name matching more than one folder returns 409. /prints only.
type={value}One of final, original, paw, nose, life_print, combo. Anything else returns 400. type=nose is the same as paw, since nose scans are stored as paw prints.
type=originalOnly originals (raw uploads with no exported print).
include=originalsReturn finals and originals together.
limit, offsetPagination. limit is 20 by default, 100 at most. Values out of range are clamped, not rejected.

Rate limits

100 requests per minute per API key. Going over returns status 429 with a Retry-After header.

Calling from a browser

If you call the API from a web page, such as your customer portal, add your domain to the Allowed Origins for your API key in the portal. Without it, browsers block the request.

Webhooks

Webhooks send each new lead to your CRM the moment it is captured, so you do not have to keep asking /leads. Set them up in the portal under Integrations, on the Webhooks tab. You can add an endpoint for all widgets or just one, send a test event, rotate the signing secret, and see every delivery.

The lead.created event

When a lead is captured, we POST this body to each active endpoint. The data object has the same fields as the lead field reference above.

POST <your endpoint>
X-Remembrance-Signature: t=1718000000,v1=<hex hmac>

{
  "event": "lead.created",
  "created_at": "2026-06-07T00:00:00Z",
  "webhook_id": "...",
  "data": { ...same fields as GET /leads... }
}

Checking the signature

Every request carries X-Remembrance-Signature: t=<timestamp>,v1=<hex>. To check it:

  1. Read the raw request body. Do not re-serialize it.
  2. Read t and v1 from the header.
  3. Compute HMAC-SHA256(signing_secret, "<t>.<raw_body>") as hex.
  4. Compare it to v1 with a constant-time comparison.
  5. Reject the request if t is older than your tolerance, for example 5 minutes, to block replays.

Retries

Reply with a 2xx status quickly to acknowledge. Anything else, or a timeout, is retried with exponential backoff, up to 6 attempts. After that the delivery is marked exhausted. Every attempt shows in the delivery log in the portal, where you can resend it.