We collect minimal analytics to understand how the site is used. If you decline, we do not load analytics.
AnchorGridAnchorGrid
AG:API
Docs
Docs/Endpoints/POST /drawings/detection/toilets
POST/v1/drawings/detection/toilets

Detect toilets and plumbing fixtures in architectural floor-plan PDFs. Accepts a previously uploaded document_id, enqueues inference, and returns a job you poll for results. Detections are returned as bounding boxes in PDF coordinate space along with a per-detection confidence score.

Floor plansAsync · 2022 credits / page

Example run

Input
Floor plan inputFloor plan with detected toilets

Request

↑

This endpoint requires a document_id. Upload your PDF first →

Auth via X-API-Key header. Body is JSON — this endpoint does not accept file uploads directly.

document_idreq
string (UUID)
ID of the uploaded PDF. Must belong to this account and not be expired.
page_numbers
int[]
1-based page indices to scan. Omit to scan all pages. Out-of-range values are skipped by the worker but still billed.
webhook_url
string
URL to POST the completed job payload to. Delivered on developer, pro, and enterprise tiers only.
ℹ

Credits are charged on submission based on len(page_numbers) (or the document's total page count when omitted) — not on pages that actually contain toilets. Send only valid page indices to avoid over-billing.

Code examples

curl -X POST https://api.anchorgrid.ai/v1/drawings/detection/toilets \
  -H "X-API-Key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "document_id": "550e8400-e29b-41d4-a716-446655440000",
    "page_numbers": [1, 2, 3]
  }'

Response — 202 Accepted

The job is enqueued immediately. Poll GET /v1/jobs/{job_id} until status is complete or failed.

job_id
string (UUID)
Use this to poll for results.
status
string
Always queued on this response.
poll_url
string
Path only — prepend https://api.anchorgrid.ai to build the full URL.

Result shape

When status === "complete" and model === "toilet-detector", the result field on the job contains:

document_id
string
UUID of the source document.
toilets
array
List of toilet detections. Each item has id, page, bbox, and confidence.
toilets[].id
string
Stable identifier — "tlt_" + 12 hex chars.
toilets[].page
integer
1-based PDF page index where the fixture was detected.
toilets[].bbox
object
Axis-aligned bounding box in PDF coordinate space: x1, y1, x2, y2.
toilets[].confidence
float
Model confidence score for this detection, between 0 and 1.
toilets_found
integer
Count of items in the toilets array.
pages_analyzed
integer
Number of pages the worker actually scanned.
model_version
string
e.g. toilet-detector-v1.0.0
processing_time_ms
integer
Wall time for the inference task.
ℹ

Detections include a confidence score. Scores above 0.5 are high-confidence fixtures. Lower-confidence detections (0.12–0.5) may warrant manual review, particularly for rotated or non-standard fixture symbols.

Credits & rate limits

Cost
2 credits × pages billed
Rate limit
Tier RPM (5 / 60 / 120 / 300)
free
Lifetime credit cap — 402 FREE_TIER_LIMIT_REACHED when exceeded.
developer / pro
Monthly pool — 429 QUOTA_EXCEEDED when exceeded.
enterprise
No quota check.

Rate-limit 429s include retry_after_seconds in the body. Quota 429s and rate-limit 429s return the same status code — check the error body to distinguish them.

Errors

401
Missing or invalid X-API-Key.
402
Free tier lifetime credit cap reached.
404
document_id not found or expired.
422
Validation error — malformed UUID or invalid body.
429
Rate limit or monthly quota exceeded.

Response Preview

202 OK
{
  "job_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
  "status": "queued",
  "poll_url": "/v1/jobs/7c9e6679-7425-40de-944b-e07fc1f90ae7"
}