# Bristol Stool Form Scale Lookup (Lewis 1997)

> Bristol Stool Form Scale Lookup (Lewis 1997) is a paid API for AI agents from api.magentlab.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Returns the Bristol Stool Form Scale type number and its published textual description for a caller-assigned stool type integer (1–7).

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/bristol_stool
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bristol-stool-form-scale-lookup-lewis-1997-41aa8e63
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zCjzXHaHAdCjyVfhXbcHm

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability bristol-stool-form-scale-lookup-lewis-1997-41aa8e63
```

Example prompt: Look up Bristol Stool Form Scale type 4 and give me the published Lewis 1997 description for what that stool form looks like.

## When to prefer this

Use this endpoint when you need the standardized Lewis 1997 Bristol Stool Form Scale textual wording for a specific stool type integer already determined by the caller. It is a pure reference lookup — not a diagnostic tool and not a classifier. Prefer this over manual lookup tables when automating clinical documentation, health app logging, or patient education workflows that require the exact published scale wording.

## Known failure modes

- stool_type outside 1–7 range returns an error or empty result
- missing required stool_type query parameter returns 400 or validation error
- payment not included or insufficient triggers 402 Payment Required
- non-integer stool_type value causes schema validation failure

## How this service works

Lewis 1997 Bristol stool form scale: caller-assigned stool_type 1-7. Returns the assigned type and the published form wording (hard lumps like nuts through watery, entirely liquid). Stool form correlates with whole-gut transit time. magent does not inspect stool. Not a diagnosis, not constipation or diarrhea bands, and not a Rome IBS subtype.

## Output

Returns the caller-assigned Bristol stool type integer (1–7) and the corresponding published Lewis 1997 textual description of that stool form (e.g. type 1: 'separate hard lumps, like nuts'; type 7: 'watery, no solid pieces, entirely liquid'). Does not perform any stool inspection, diagnosis, or classification into IBS subtypes or constipation/diarrhea bands.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "stool_type"
     ],
     "properties": {
      "stool_type": {
       "type": "integer",
       "description": "Lewis 1997 Bristol stool form scale type 1-7 as assigned by the caller (1 separate hard lumps, like nuts; 2 sausage-shaped but lumpy; 3 like a sausage but with cracks on its surface; 4 like a sausage or snake, smooth and soft; 5 soft blobs with clear-cut edges; 6 fluffy pieces with ragged edges, a mushy stool; 7 watery, no solid pieces, entirely liquid). magent does not inspect stool."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bristol-stool-form-scale-lookup-lewis-1997-41aa8e63/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.magentlab.com](https://www.zero.xyz/host/api.magentlab.com/llms.txt)