Skip to main content
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:
ParameterTypeDescription
created_afterdatetimeOnly records created after this timestamp (ISO 8601)
created_beforedatetimeOnly 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

ParameterTypeDescription
project_idstringJobs in this project
statusstringFilter by status: Queued, Started, Completed, Failed, Canceled
typestringFilter by job type (e.g., compare)
target_typestringFilter by target resource type: drawing, sheet, block, overlay
target_idstringFilter by target resource ID
parent_idstringChild 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

ParameterTypeDescription
project_idstringRequired. Drawings in this project
namestringFilter 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

ParameterTypeDescription
drawing_idstringSheets in this drawing
project_idstringSheets across all drawings in a project
disciplinestringFilter by discipline (e.g., architectural, structural)
sheet_numberstringExact 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

ParameterTypeDescription
sheet_idstringBlocks on this sheet
typestringFilter 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

ParameterTypeDescription
project_idstringOverlays in this project
job_idstringOverlays created by a specific comparison job
drawing_idstringOverlays involving blocks from this drawing
has_changesbooleanOnly 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

ParameterTypeDescription
project_idstringRequired. Files in this project
content_typestringFilter 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.