Skip to main content

Pet portraits

Portraits turn a pet's photos into artwork in one of several styles. Owners share them, which makes them useful for acquisition and for giving people a reason to come back.

List the styles available to you. Use an id from this list, since styles are added and retired over time and an unknown one returns 400:

curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/pets/portrait-styles
curl -X POST -H "x-api-key: YOUR-API-KEY" -H "Content-Type: application/json" \
  -d '{"style": "studio"}' \
  https://api.thedogapi.com/v1/pets/{pet_id}/portrait

List a pet's portraits:

curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/pets/{pet_id}/portraits

Example images are in Pets & Pet Analysis.

Portraits are stored against the pet but are never used as input to any health analysis, so generating them does not affect body condition, breed or age results.

If portraits don't suit your brand​

Not every product wants them. Switch portraits off (portraits) and both portrait endpoints return 403 for your account, so nobody on your team can ship them by accident.