Filtering

All list endpoints accept query parameters to filter results. Filters are combined with AND logic — only records matching all specified filters are returned.

Common Filters

These filters are available on most list endpoints:

Parameter	Type	Description
`created_after`	datetime	Only records created after this timestamp (ISO 8601)
`created_before`	datetime	Only records created before this timestamp (ISO 8601)

# Drawings created in the last 7 days
curl "https://api.bedrock.cv/drawings?project_id=prj_01X&created_after=2024-01-08T00:00:00Z" \
  -H "Authorization: Bearer sk_xxx"

Resource-Specific Filters

Jobs

Parameter	Type	Description
`project_id`	string	Jobs in this project
`status`	string	Filter by status: `Queued`, `Started`, `Completed`, `Failed`, `Canceled`
`type`	string	Filter by job type (e.g., `compare`)
`target_type`	string	Filter by target resource type: `drawing`, `sheet`, `block`, `overlay`
`target_id`	string	Filter by target resource ID
`parent_id`	string	Child jobs of a parent job

# All failed compare jobs in a project
curl "https://api.bedrock.cv/jobs?project_id=prj_01X&status=Failed&type=compare" \
  -H "Authorization: Bearer sk_xxx"

# All child jobs of a drawing comparison
curl "https://api.bedrock.cv/jobs?parent_id=job_01JABCD123" \
  -H "Authorization: Bearer sk_xxx"

Drawings

Parameter	Type	Description
`project_id`	string	Required. Drawings in this project
`name`	string	Filter by name (case-insensitive substring match)

curl "https://api.bedrock.cv/drawings?project_id=prj_01X&name=floor%20plan" \
  -H "Authorization: Bearer sk_xxx"

Sheets

Parameter	Type	Description
`drawing_id`	string	Sheets in this drawing
`project_id`	string	Sheets across all drawings in a project
`discipline`	string	Filter by discipline (e.g., `architectural`, `structural`)
`sheet_number`	string	Exact match on sheet number (e.g., `A-101`)

# All architectural sheets in a drawing
curl "https://api.bedrock.cv/sheets?drawing_id=drw_01X&discipline=architectural" \
  -H "Authorization: Bearer sk_xxx"

# Find sheet A-101 across all drawings in a project
curl "https://api.bedrock.cv/sheets?project_id=prj_01X&sheet_number=A-101" \
  -H "Authorization: Bearer sk_xxx"

Blocks

Parameter	Type	Description
`sheet_id`	string	Blocks on this sheet
`type`	string	Filter by block type (e.g., `Plan`, `Detail`, `Schedule`)

# All plan blocks on a sheet
curl "https://api.bedrock.cv/blocks?sheet_id=sht_01X&type=Plan" \
  -H "Authorization: Bearer sk_xxx"

Overlays

Parameter	Type	Description
`project_id`	string	Overlays in this project
`job_id`	string	Overlays created by a specific comparison job
`drawing_id`	string	Overlays involving blocks from this drawing
`has_changes`	boolean	Only overlays where change detection has been run (`true`) or not (`false`)

# Overlays from a specific comparison, with changes detected
curl "https://api.bedrock.cv/overlays?job_id=job_01X&has_changes=true" \
  -H "Authorization: Bearer sk_xxx"

Files

Parameter	Type	Description
`project_id`	string	Required. Files in this project
`content_type`	string	Filter by MIME type (e.g., `application/pdf`)

Combining Filters with Pagination

Filters work alongside cursor-based pagination:

# Page through completed jobs
curl "https://api.bedrock.cv/jobs?project_id=prj_01X&status=Completed&limit=50" \
  -H "Authorization: Bearer sk_xxx"

# Next page
curl "https://api.bedrock.cv/jobs?project_id=prj_01X&status=Completed&limit=50&cursor=eyJ..." \
  -H "Authorization: Bearer sk_xxx"

Filters are encoded into the cursor, so you don’t need to repeat filter parameters when paging — just pass the cursor.

Getting Started

CMS API

Vision API

Errors

Common Filters

Resource-Specific Filters

Jobs

Drawings

Sheets

Blocks

Overlays

Files

​Common Filters

​Resource-Specific Filters

​Jobs

​Drawings

​Sheets

​Blocks

​Overlays

​Files

​Combining Filters with Pagination

Common Filters

Resource-Specific Filters

Jobs

Drawings

Sheets

Blocks

Overlays

Files

Combining Filters with Pagination