Classify drawings

Drawing classification

POST/v1/drawings/classify

Classifies every page of a drawing set — identifying drawing numbers, titles, drawing types (floor plan, elevation, schedule, etc.), CSI divisions, scope, and floor level. Returns a structured index grouped by drawing type. This is an async job — submit and poll.

Returns: A job to check202 Accepted
Usage: Document indexingper page read
Results in: A sheet indexresult.pages · result.by_drawing_type
Auth: Bearer tokenAuthorization header

How it runs

Send a document_id
Get a job_id
Check your results or receive a webhook

Request

This endpoint requires a document_id. Upload your PDF first.

Auth via Authorization: Bearer <api_key> header. Body is JSON.

Field	Description
`document_id`string · UUIDRequired	ID from POST /v1/documents. Must belong to this account and not be expired.
`page_numbers`array of integersOptional	1-based page list. Omit to classify all pages.
`webhook_url`string · URLOptional	URL to POST the completed job payload to. Delivered on developer, pro, and enterprise tiers only.

Header	Description
`Authorization`Required	`Bearer <api_key>`
`Content-Type`Required	`application/json`

UsageClassification counts as document indexing on each page it reads (See pricing). Usage is recorded when the job is submitted.

Responses

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

Field	Description
`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.

When status is complete, the result field on the job contains:

Field	Description
`pages_analyzed`integer	Total pages processed.
`model_version`string	e.g. `page-classifier-v2.0.0`
`processing_time_ms`integer	Wall time for the classification task.
`by_drawing_type`object	Page numbers grouped by drawing type — the fastest way to find all floor plans, schedules, etc. without iterating the full pages array.
`pages[].page_number`integer	1-based page index.
`pages[].drawing_number`string	Sheet number as printed (e.g. A-101, E-201).
`pages[].title`string	Drawing title as printed on the sheet.
`pages[].document_type`string	Discipline — ARCHITECTURAL, ELECTRICAL, MECHANICAL, etc.
`pages[].drawing_type`string	Sheet category — FLOOR_PLAN, ELEVATION, SCHEDULE, SECTION, DETAIL, GENERAL, etc.
`pages[].division`object	CSI MasterFormat division with code and name fields.
`pages[].scope`string[]	Key elements visible on the page.
`pages[].floor`string	Floor or level reference (Level 1, Roof, etc.) — empty string if not applicable.
`pages[].description`string	Plain-English summary of the page content.

Use by_drawing_type to quickly locate all sheets of a given type. Iterate pages only when you need per-page metadata like drawing numbers, titles, or CSI divisions.

Usage & rate limits

Document indexing, per page read (See pricing). Typical time: ~2–3 min per 130 pages.

Plan	When the allowance is used up
`trial`	Trial allowance — `402 FREE_TIER_LIMIT_REACHED` when used up, `402 TRIAL_ENDED` once the trial is over.
`developer`	Monthly allowance, then overage up to your overage limit — `402 OVERAGE_LIMIT_REACHED` at the limit (`429 QUOTA_EXCEEDED` when the allowance is used up without overage billing).
`enterprise`	No allowance check.

Errors

Status	What it means
404DOCUMENT_NOT_FOUND	document_id doesn’t exist or has expired.
402FREE_TIER_LIMIT_REACHED	Trial allowance used up — upgrade required.
402TRIAL_ENDED	The trial has ended — upgrade or ask us to extend it.
402OVERAGE_LIMIT_REACHED	The job would pass your overage limit for this billing period.
429QUOTA_EXCEEDED	Monthly allowance used up (no overage billing).

Examples

curl -X POST https://api.anchorgrid.ai/v1/drawings/classify \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "document_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
  }'

Response · 202

{
  "job_id": "8d4eda21-d444-4556-9c1f-fe050c673008",
  "status": "queued",
  "poll_url": "/v1/jobs/8d4eda21-d444-4556-9c1f-fe050c673008"
}

Completed job · result

{
  "document_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "pages_analyzed": 133,
  "model_version": "page-classifier-v2.0.0",
  "processing_time_ms": 14823,
  "by_drawing_type": {
    "FLOOR_PLAN": [
      1,
      2,
      3,
      4
    ],
    "ELEVATION": [
      5,
      6,
      7
    ],
    "SCHEDULE": [
      12,
      13
    ],
    "ELECTRICAL": [
      20,
      21,
      22
    ],
    "SECURITY": [
      129,
      130
    ]
  },
  "pages": [
    {
      "page_number": 1,
      "drawing_number": "A-101",
      "title": "FIRST FLOOR PLAN",
      "document_type": "ARCHITECTURAL",
      "drawing_type": "FLOOR_PLAN",
      "division": {
        "code": "09",
        "name": "Finishes"
      },
      "scope": [
        "walls",
        "doors",
        "room labels"
      ],
      "floor": "Level 1",
      "description": "Overall first floor architectural plan showing room layout, wall types, and door locations."
    }
  ]
}