Ear Canal Analysis - Poomi Docs

Upload a photo of your pet's ear to analyze for infections, mites, wax buildup, and other ear conditions.

POST/api/v1/ear-analysis

Image5 Credits per call

Field	Type	Required	Description
`image`	`string`	Yes	Base64-encoded image data (JPG/PNG/WEBP, max 3MB)
`animalType`	`string`	No	Animal type for analysis (e.g. dog, cat, rabbit, hamster)
`language`	`string`	No	Response language code (en, zh, es)

API Playground

Animal Type

Language

Request Example

bash

curl -X POST https://www.poomi.pet/api/v1/ear-analysis \
  -H "Authorization: Bearer pk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "base64_encoded_data",
    "animalType": "dog",
    "language": "en"
  }'

Response Fields

Field	Type	Required	Description
`severity`	`string`	Yes	Overall severity of the visible ear findings
`condition`	`string`	Yes	Short owner-facing label for the visible ear condition
`summary`	`string`	Yes	A concise 2 to 4 sentence summary covering the key visible observations, the overall interpretation, and any important limitation
`home_care`	`array<string>`	Yes	Practical at-home care or monitoring steps. MUST contain at least 2 items, even when the findings look normal — fall back to routine daily care or monitoring suggestions in that case.
`vet_advice`	`array<string>`	Yes	When veterinary follow-up is appropriate based on the visible findings. Use an empty array when none are needed.

Response Schema

json-schema

{
  "type": "object",
  "properties": {
    "severity": {
      "type": "string",
      "description": "Overall severity of the visible ear findings",
      "enum": [
        "normal",
        "mild",
        "moderate",
        "severe",
        "inconclusive"
      ]
    },
    "condition": {
      "type": "string",
      "description": "Short owner-facing label for the visible ear condition"
    },
    "summary": {
      "type": "string",
      "description": "A concise 2 to 4 sentence summary covering the key visible observations, the overall interpretation, and any important limitation"
    },
    "home_care": {
      "type": "array",
      "description": "Practical at-home care or monitoring steps. MUST contain at least 2 items, even when the findings look normal — fall back to routine daily care or monitoring suggestions in that case.",
      "items": {
        "type": "string"
      },
      "minItems": 2
    },
    "vet_advice": {
      "type": "array",
      "description": "When veterinary follow-up is appropriate based on the visible findings. Use an empty array when none are needed.",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "severity",
    "condition",
    "summary",
    "home_care",
    "vet_advice"
  ],
  "additionalProperties": false
}

Response Example

json200 OK

{
  "success": true,
  "request_id": "req_xxxxxxxx",
  "data": {
    "severity": "normal",
    "condition": "appears within normal limits",
    "summary": "The visible ear entrance looks pink and reasonably clean in this image. I do not see obvious redness, discharge, swelling, or heavy debris in the visible portion. The photo does not show the deep canal, but the visible area appears within normal limits.",
    "home_care": [
      "Do a quick visual ear check once a week for redness, discharge, or unusual smell",
      "Gently dry the outer ear after baths or swimming to prevent moisture buildup",
      "Watch for head shaking, scratching at the ears, or new odor and recheck if any appear"
    ],
    "vet_advice": []
  }
}