Breeder API

Breeder API — favourites

Read your favourited listings via the Breeder API.

List favourited listings

Returns listings you have saved as favourites, ordered by when you saved them (newest first). Useful for syncing your watchlist to external tools.

Parameter	Type	Required	Description
limit	integer	Optional	Number of results per page (1–100, default 20)
cursor	string	Optional	Pagination cursor from the previous response

GET /api/breeder/favourites

curl https://herpify.com/api/breeder/favourites \
  -H "Authorization: Bearer hm_live_your_key_here"

Response

{
  "data": [
    {
      "listingId": "clx1a2b3c4d5e",
      "savedAt": "2026-05-01T08:00:00.000Z",
      "listing": {
        "id": "clx1a2b3c4d5e",
        "slug": "pastel-ball-python",
        "title": "Pastel Ball Python",
        "price": 250.00,
        "currency": "USD",
        "status": "ACTIVE",
        "listingType": "SALE",
        "species": { "id": "...", "commonName": "Ball Python", "slug": "ball-python" },
        "location": { "city": "Austin", "region": "Texas", "countryCode": "US" },
        "images": [{ "id": "...", "cdnUrl": "https://...", "width": 800, "height": 600 }]
      }
    }
  ],
  "meta": { "limit": 20, "hasMore": false, "nextCursor": null }
}

Important note

Favourites are read-only via the API. Use the Herpify app to add or remove favourites.

Was this article helpful?