Skin Analysis - Poomi Docs

Upload a photo of your pet's skin condition to analyze rashes, lesions, hair loss, and other dermatological indicators.

POST/api/v1/skin-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/skin-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 skin findings
`condition`	`string`	Yes	Short owner-facing label for the visible skin 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 skin findings",
      "enum": [
        "normal",
        "mild",
        "moderate",
        "severe",
        "inconclusive"
      ]
    },
    "condition": {
      "type": "string",
      "description": "Short owner-facing label for the visible skin 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 skin and coat look within normal limits in this image. I do not see clear redness, hair loss, crusting, discharge, or open lesions on the visible surface. This photo cannot rule out itching, pain, or microscopic skin issues.",
    "home_care": [
      "Brush the coat regularly with a gentle brush to check skin and remove loose hair",
      "Keep the area clean and dry, and avoid harsh shampoos or unfamiliar topical products",
      "Watch for new redness, scratching, hair loss, or odor over the next 1-2 weeks"
    ],
    "vet_advice": []
  }
}