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 (en, zh, es)

API Playground

Animal Type

Language

Request Example

bash

curl -X POST https://www.poomi.pet/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. 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 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. 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",
    "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": [
      "Keep fresh water available at all times to support steady hydration",
      "Maintain normal litter box or potty routines and keep them clean",
      "Watch urination frequency, volume, and color over the next few days for any changes"
    ],
    "vet_advice": []
  }
}