Vomit Analysis - Poomi Docs

Upload a photo of your pet's vomit to analyze its composition, color, and texture for potential health indicators.

POST/api/v1/vomit-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 (zh, en)

API Playground

Animal Type

Language

Request Example

bash

curl -X POST https://poomi.cn/api/v1/vomit-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 vomiting sample
`vomit_type`	`string`	Yes	Most likely vomit category based on what is visible
`color`	`string`	Yes	Observed vomit color
`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. Use an empty array when none are needed.
`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 vomiting sample",
      "enum": [
        "mild",
        "moderate",
        "severe",
        "inconclusive"
      ]
    },
    "vomit_type": {
      "type": "string",
      "description": "Most likely vomit category based on what is visible"
    },
    "color": {
      "type": "string",
      "description": "Observed vomit color"
    },
    "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. Use an empty array when none are needed.",
      "items": {
        "type": "string"
      }
    },
    "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",
    "vomit_type",
    "color",
    "summary",
    "home_care",
    "vet_advice"
  ],
  "additionalProperties": false
}

Response Example

json200 OK

{
  "success": true,
  "request_id": "req_xxxxxxxx",
  "data": {
    "severity": "mild",
    "vomit_type": "food regurgitation",
    "color": "light tan",
    "summary": "This sample looks most consistent with a mild food regurgitation or vomit episode. I do not see obvious blood, large amounts of bile, or a clearly concerning foreign object in the visible material. The image alone is not enough to identify a single definite cause.",
    "home_care": [
      "Monitor for repeated vomiting, lethargy, pain, or trouble keeping water down"
    ],
    "vet_advice": []
  }
}