Urine Analysis - Poomi Docs

Upload a photo of your pet's urine to analyze color, clarity, and other visual indicators for potential health issues.

POST/api/v1/urine-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/urine-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 urine findings
`color`	`string`	Yes	Observed urine color
`clarity`	`string`	Yes	Observed urine clarity or cloudiness
`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 urine findings",
      "enum": [
        "normal",
        "mild",
        "moderate",
        "severe",
        "inconclusive"
      ]
    },
    "color": {
      "type": "string",
      "description": "Observed urine color"
    },
    "clarity": {
      "type": "string",
      "description": "Observed urine clarity or cloudiness"
    },
    "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",
    "color",
    "clarity",
    "summary",
    "home_care",
    "vet_advice"
  ],
  "additionalProperties": false
}

Response Example

json200 OK

{
  "success": true,
  "request_id": "req_xxxxxxxx",
  "data": {
    "severity": "normal",
    "color": "pale yellow",
    "clarity": "clear",
    "summary": "The visible urine appears within normal limits in this image. It looks pale yellow and fairly clear, without obvious blood or heavy sediment. Image-only review cannot confirm odor, volume, or microscopic findings.",
    "home_care": [],
    "vet_advice": []
  }
}