Pets & Pet Analysis

Manage your pets, upload their photos, and leverage powerful AI to analyze their health, age, and breed composition. This controller allows for comprehensive pet profile management and advanced computer vision analysis.

Core Management

Create a Pet

Create a profile for your pet. You can include multiple initial images during creation by repeating the images field.

curl -X POST -H "x-api-key: YOUR-API-KEY" -H "Content-Type: multipart/form-data" \
  -F "name=Buddy" \
  -F "breed_id=15" \
  -F "date_of_birth=2022-06-15" \
  -F "sub_id=my-user-123" \
  -F "description=My best friend" \
  -F "images=@/path/to/front_view.jpg" \
  -F "images=@/path/to/side_view.jpg" \
  https://api.thedogapi.com/v1/pets

List your Pets

Retrieve a paginated list of all pets associated with your account.

curl -H "x-api-key: YOUR-API-KEY" "https://api.thedogapi.com/v1/pets?limit=10&page=0"

Get Pet Details

Retrieve full profile details for a specific pet, including all their uploaded images.

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

Update a Pet

Update metadata like name, breed, or description.

curl -X PATCH -H "x-api-key: YOUR-API-KEY" -H "Content-Type: application/json" \
  -d '{"description": "Loves playing fetch"}' \
  https://api.thedogapi.com/v1/pets/{pet_id}

---

Media Management

Upload Pet Images

To upload additional photos for an existing pet, use the /images sub-resource. This is useful for providing the AI with more reference angles for higher-quality analysis.

curl -X POST -H "x-api-key: YOUR-API-KEY" -H "Content-Type: multipart/form-data" \
  -F "images=@/path/to/photo_3.jpg" \
  -F "images=@/path/to/photo_4.jpg" \
  https://api.thedogapi.com/v1/pets/{pet_id}/images

---

AI Health & Condition Analysis

Computer vision algorithms analyze your pet's images to provide quantitative and qualitative insights.

Body Condition Score (BCS)

The AI analyzes profile and overhead photos to determine if a pet is underweight, ideal, or overweight.

curl -X POST -H "x-api-key: YOUR-API-KEY" \
  https://api.thedogapi.com/v1/pets/{pet_id}/body-condition-score

Example Output

{
  "score": 5,
  "reasons": [
    "Ribs are easily palpable with minimal fat cover.",
    "Waist is easily noted when viewed from above.",
    "Abdominal tuck is evident when viewed from the side."
  ],
  "generated_at": "2024-03-23T10:00:00.000Z"
}

Muscle Condition Score

Analyzes muscle mass across the spine, scapulae, and hips to identify risks of muscle wasting.

curl -X POST -H "x-api-key: YOUR-API-KEY" \
  https://api.thedogapi.com/v1/pets/{pet_id}/muscle-condition-score

Estimated Age

If a pet's exact history is unknown, our AI can estimate their age by analyzing physical indicators.

curl -X POST -H "x-api-key: YOUR-API-KEY" \
  https://api.thedogapi.com/v1/pets/{pet_id}/estimated-age

---

Genealogy & Breed Insights

Understand your pet's ancestry through visual pattern recognition.

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

Genealogy Response

{
  "breed_mixture": [
    { "id": 121, "name": "Golden Retriever", "percentage": 75 },
    { "id": 149, "name": "Labrador Retriever", "percentage": 25 }
  ],
  "creative_description": "A loyal and energetic companion with a sun-kissed coat.",
  "gender_prediction": "male"
}

---

AI Portraits

Generate stylized, professional-quality artwork featuring your pet.

1. List Available Styles

curl -H "x-api-key: YOUR-API-KEY" https://api.thedogapi.com/v1/pets/portrait-styles

2. Generate Artwork

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

Studio	Pack Leader	Birthday

---

Cleanup

Delete a Pet

Permanently remove a pet profile and all associated data.

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