List images
/rest/v1.0/imagesInspect fields and contractA Procore MCP connector in development for projects, RFIs, submittals and commercial records. Explore planned coverage and join the waitlist.
Construction
MCP XYZ is building an independent Procore MCP connector for teams that want an AI assistant to work with authorised construction project records through the Model Context Protocol. Planned coverage includes projects, RFIs, submittals, daily logs and commercial records. Access is waitlist-based while provider approval and live acceptance are pending.
Use the catalogue to check the operations and fields your work needs. If an existing connector is missing a useful action, tell us about it when joining the waitlist. Your software’s permissions and API limits still apply.
Planned access to projects, company information, people and project directories, within the connected account’s authorised permissions.
Inspect documented operationsInspect documented requests for information, submittals, drawing records and daily logs before choosing a project workflow.
Inspect documented operationsExplore documented commercial records, including change events, commitments and prime contracts. Live acceptance is still pending.
Inspect documented operations“Find the open RFIs for this project.”
New access starts with the Procore waitlist. Tell us which assistant you use and the work you want to do. We’ll contact you about relevant access updates; joining does not create an account or guarantee an invitation date.
Procore is in development. Live use requires an authorised developer app, installation in the relevant company, applicable provider approval and live acceptance.
The implemented connection paths support a developer-managed service account or user OAuth. Acceptance must confirm the account, region, permissions and intended agent use. The detailed catalogue tracks documented coverage; these workflows have not passed live business testing.
Production use needs the applicable Procore app and use-case approval. Procore’s Agentic APIs programme is a separate approved pilot. Ordinary REST credentials do not establish access to that pilot or approval for every agent or bulk-data use.
External presigned transfers, large uploads, some environments and provider-side token revocation have outstanding limits. A documented file operation does not mean a complete file workflow has been verified.
Procore API usage guidelines
Procore Agentic APIs guidance
Documented coverage
3,294 documented business operations across retained API versions. Open a contract to inspect its parameters, fields, sources and unresolved behaviour. No provider request is made here.
3,294 operations match. Showing 1341–1360.
/rest/v1.0/imagesInspect fields and contract/rest/v1.0/installation_requestsInspect fields and contract/rest/v1.0/line_item_types/{id}Inspect fields and contract/rest/v1.0/line_item_typesInspect fields and contract/rest/v1.0/links/{id}Inspect fields and contract/rest/v1.0/links/recycle_binInspect fields and contract/rest/v1.0/linksInspect fields and contract/rest/v1.0/local_files/{uuid}Inspect fields and contract/rest/v1.0/locations/{id}Inspect fields and contract/rest/v1.0/locationsInspect fields and contract/rest/v1.0/meInspect fields and contract/rest/v1.0/meeting_categoriesInspect fields and contract/rest/v1.0/meeting_topics/parent_minutesInspect fields and contract/rest/v1.0/meetings/{id}Inspect fields and contract/rest/v1.0/meetings/ecrion_pdf_generation_dataInspect fields and contract/rest/v1.0/meetingsInspect fields and contract/rest/v1.0/observations/assigneesInspect fields and contract/rest/v1.0/observations/category_configurable_field_setsInspect fields and contract/rest/v1.0/observations/default_distributionInspect fields and contract/rest/v1.0/observations/items/{id}/pdfInspect fields and contractDocumented contract, live behaviour unverified
procore_get_images_v1_0Read the provider documentation
| Parameter | Required | Provider description |
|---|---|---|
project_id | Yes | Unique identifier for the project. |
image_category_id | No | Optional. ID of the image category to filter the images by. |
page | No | Page |
per_page | No | Elements per page |
filters[daily_log_segment_id] | No | Daily Log Segment ID filter |
filters[log_date] | No | Date of Photos added to the Daily Log in the format "YYYY-MM-DD", or a range of dates in the format "YYYY-MM-DD...YYYY-MM-DD". |
filters[private] | No | If true, returns only item(s) with a `private` status. |
filters[starred] | No | If true, returns only item(s) with a `starred` status. This will be ignored for users without permission to star photos, returning the unfiltered list rather than an error. |
filters[location_id] | No | Location ID. Returns item(s) with the specified Location ID or a range of Location IDs. |
filters[include_sublocations] | No | Use together with `filters[location_id]` |
filters[trade_ids] | No | Array of Trade IDs. Returns item(s) with the specified Trade IDs. |
filters[projection] | No | Return items with the specified projection type. |
filters[query] | No | Return item(s) containing search query |
filters[created_at] | No | Return item(s) created within the specified ISO 8601 datetime range. Formats: `YYYY-MM-DD`...`YYYY-MM-DD` - Date `YYYY-MM-DDTHH:MM:SSZ`...`YYYY-MM-DDTHH:MM:SSZ` - DateTime with UTC Offset `YYYY-MM-DDTHH:MM:SS+XX:00...`YYYY-MM-DDTHH:MM:SS+XX:00` - Datetime with Custom Offset |
filters[updated_at] | No | Return item(s) last updated within the specified ISO 8601 datetime range. Formats: `YYYY-MM-DD`...`YYYY-MM-DD` - Date `YYYY-MM-DDTHH:MM:SSZ`...`YYYY-MM-DDTHH:MM:SSZ` - DateTime with UTC Offset `YYYY-MM-DDTHH:MM:SS+XX:00`...`YYYY-MM-DDTHH:MM:SS+XX:00` - Datetime with Custom Offset |
filters[uploader_id] | No | Return item(s) uploaded by the specified User IDs |
filters[id] | No | Return item(s) with the specified IDs. |
sort | No | Field to sort by. If the field is passed with a - (EX: -created_at) it is sorted in reverse order |
serializer_view | No | The data set that should be returned from the serializer. The normal view includes default fields, plus links, comments_count, trades. The android view includes default fields, plus trades, comments. The mobile view include default fields, plus log_date, trades, comments. The mobile_feed view includes default fields, plus comments. The prostore_file view includes default fields, plus images. The ids_only view does not include default fields, response returns strictly an array of image ids. Default view is normal. |
The exact retained JSON includes schemas, nested fields, notes, source evidence and unresolved questions. It is a documented contract, not a live response.
{
"id": "get_images_v1_0",
"name": "procore_get_images_v1_0",
"resourceId": "images",
"description": "List images",
"method": "GET",
"path": "/rest/v1.0/images",
"version": "1.0",
"documentationUrl": "https://developers.procore.com/reference/rest/images?version=1.0",
"readOnly": true,
"destructive": false,
"idempotent": true,
"deprecated": false,
"beta": false,
"canonical": true,
"pathParameters": [],
"queryParameters": [
{
"name": "project_id",
"in": "query",
"required": true,
"description": "Unique identifier for the project.",
"schema": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[0-9]+$"
}
],
"x-mcp-original-type": "integer"
}
},
{
"name": "image_category_id",
"in": "query",
"description": "Optional. ID of the image category to filter the images by.",
"required": false,
"schema": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[0-9]+$"
}
],
"x-mcp-original-type": "integer"
}
},
{
"name": "page",
"in": "query",
"description": "Page",
"schema": {
"type": "integer"
}
},
{
"name": "per_page",
"in": "query",
"description": "Elements per page",
"schema": {
"type": "integer"
}
},
{
"example": [
123456
],
"name": "filters[daily_log_segment_id]",
"in": "query",
"description": "Daily Log Segment ID filter",
"schema": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[0-9]+$"
}
],
"x-mcp-original-type": "integer"
}
}
},
{
"name": "filters[log_date]",
"in": "query",
"required": false,
"description": "Date of Photos added to the Daily Log in the format \"YYYY-MM-DD\", or a range of dates in the format \"YYYY-MM-DD...YYYY-MM-DD\".",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "filters[private]",
"in": "query",
"description": "If true, returns only item(s) with a `private` status.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "filters[starred]",
"in": "query",
"description": "If true, returns only item(s) with a `starred` status. This will be ignored for users without permission to star photos, returning the unfiltered list rather than an error.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "filters[location_id]",
"in": "query",
"description": "Location ID. Returns item(s) with the specified Location ID or a range of Location IDs.",
"required": false,
"style": "form",
"explode": false,
"schema": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[0-9]+$"
}
],
"x-mcp-original-type": "integer"
}
}
},
{
"name": "filters[include_sublocations]",
"in": "query",
"description": "Use together with `filters[location_id]`\n",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "filters[trade_ids]",
"in": "query",
"description": "Array of Trade IDs. Returns item(s) with the specified Trade IDs.",
"style": "form",
"explode": false,
"schema": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[0-9]+$"
}
],
"x-mcp-original-type": "integer"
}
}
},
{
"name": "filters[projection]",
"in": "query",
"description": "Return items with the specified projection type.",
"required": false,
"schema": {
"type": "string",
"enum": [
"360",
"regular"
]
}
},
{
"name": "filters[query]",
"in": "query",
"description": "Return item(s) containing search query",
"schema": {
"type": "string"
}
},
{
"name": "filters[created_at]",
"in": "query",
"description": "Return item(s) created within the specified ISO 8601 datetime range.\nFormats:\n`YYYY-MM-DD`...`YYYY-MM-DD` - Date\n`YYYY-MM-DDTHH:MM:SSZ`...`YYYY-MM-DDTHH:MM:SSZ` - DateTime with UTC Offset\n`YYYY-MM-DDTHH:MM:SS+XX:00...`YYYY-MM-DDTHH:MM:SS+XX:00` - Datetime with Custom Offset",
"required": false,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "filters[updated_at]",
"in": "query",
"description": "Return item(s) last updated within the specified ISO 8601 datetime range.\nFormats:\n`YYYY-MM-DD`...`YYYY-MM-DD` - Date\n`YYYY-MM-DDTHH:MM:SSZ`...`YYYY-MM-DDTHH:MM:SSZ` - DateTime with UTC Offset\n`YYYY-MM-DDTHH:MM:SS+XX:00`...`YYYY-MM-DDTHH:MM:SS+XX:00` - Datetime with Custom Offset",
"required": false,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "filters[uploader_id]",
"in": "query",
"description": "Return item(s) uploaded by the specified User IDs",
"style": "form",
"explode": false,
"schema": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[0-9]+$"
}
],
"x-mcp-original-type": "integer"
}
}
},
{
"name": "filters[id]",
"in": "query",
"description": "Return item(s) with the specified IDs.",
"required": false,
"style": "form",
"explode": false,
"schema": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[0-9]+$"
}
],
"x-mcp-original-type": "integer"
}
}
},
{
"name": "sort",
"in": "query",
"description": "Field to sort by. If the field is passed with a - (EX: -created_at) it is sorted in reverse order",
"schema": {
"type": "string",
"enum": [
"deleted_at",
"created_at",
"exposure_date",
"taken_at",
"most_recent"
]
}
},
{
"name": "serializer_view",
"in": "query",
"description": "The data set that should be returned from the serializer.\nThe normal view includes default fields, plus links, comments_count, trades.\nThe android view includes default fields, plus trades, comments.\nThe mobile view include default fields, plus log_date, trades, comments.\nThe mobile_feed view includes default fields, plus comments.\nThe prostore_file view includes default fields, plus images.\nThe ids_only view does not include default fields, response returns strictly an array of image ids.\nDefault view is normal.",
"required": false,
"schema": {
"type": "string",
"enum": [
"normal",
"android",
"mobile",
"mobile_feed",
"prostore_file",
"ids_only"
]
}
}
],
"requestBodySchema": null,
"requestBodyRequired": false,
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "object",
"properties": {
"project_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[0-9]+$"
}
],
"description": "Unique identifier for the project.",
"x-mcp-original-type": "integer"
},
"image_category_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[0-9]+$"
}
],
"description": "Optional. ID of the image category to filter the images by.",
"x-mcp-original-type": "integer"
},
"page": {
"type": "integer",
"description": "Page"
},
"per_page": {
"type": "integer",
"description": "Elements per page"
},
"filters[daily_log_segment_id]": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[0-9]+$"
}
],
"x-mcp-original-type": "integer"
},
"description": "Daily Log Segment ID filter"
},
"filters[log_date]": {
"type": "string",
"format": "date",
"description": "Date of Photos added to the Daily Log in the format \"YYYY-MM-DD\", or a range of dates in the format \"YYYY-MM-DD...YYYY-MM-DD\"."
},
"filters[private]": {
"type": "boolean",
"default": false,
"description": "If true, returns only item(s) with a `private` status."
},
"filters[starred]": {
"type": "boolean",
"default": false,
"description": "If true, returns only item(s) with a `starred` status. This will be ignored for users without permission to star photos, returning the unfiltered list rather than an error."
},
"filters[location_id]": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[0-9]+$"
}
],
"x-mcp-original-type": "integer"
},
"description": "Location ID. Returns item(s) with the specified Location ID or a range of Location IDs."
},
"filters[include_sublocations]": {
"type": "boolean",
"default": false,
"description": "Use together with `filters[location_id]`\n"
},
"filters[trade_ids]": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[0-9]+$"
}
],
"x-mcp-original-type": "integer"
},
"description": "Array of Trade IDs. Returns item(s) with the specified Trade IDs."
},
"filters[projection]": {
"type": "string",
"enum": [
"360",
"regular"
],
"description": "Return items with the specified projection type."
},
"filters[query]": {
"type": "string",
"description": "Return item(s) containing search query"
},
"filters[created_at]": {
"type": "string",
"format": "date",
"description": "Return item(s) created within the specified ISO 8601 datetime range.\nFormats:\n`YYYY-MM-DD`...`YYYY-MM-DD` - Date\n`YYYY-MM-DDTHH:MM:SSZ`...`YYYY-MM-DDTHH:MM:SSZ` - DateTime with UTC Offset\n`YYYY-MM-DDTHH:MM:SS+XX:00...`YYYY-MM-DDTHH:MM:SS+XX:00` - Datetime with Custom Offset"
},
"filters[updated_at]": {
"type": "string",
"format": "date",
"description": "Return item(s) last updated within the specified ISO 8601 datetime range.\nFormats:\n`YYYY-MM-DD`...`YYYY-MM-DD` - Date\n`YYYY-MM-DDTHH:MM:SSZ`...`YYYY-MM-DDTHH:MM:SSZ` - DateTime with UTC Offset\n`YYYY-MM-DDTHH:MM:SS+XX:00`...`YYYY-MM-DDTHH:MM:SS+XX:00` - Datetime with Custom Offset"
},
"filters[uploader_id]": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[0-9]+$"
}
],
"x-mcp-original-type": "integer"
},
"description": "Return item(s) uploaded by the specified User IDs"
},
"filters[id]": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[0-9]+$"
}
],
"x-mcp-original-type": "integer"
},
"description": "Return item(s) with the specified IDs."
},
"sort": {
"type": "string",
"enum": [
"deleted_at",
"created_at",
"exposure_date",
"taken_at",
"most_recent"
],
"description": "Field to sort by. If the field is passed with a - (EX: -created_at) it is sorted in reverse order"
},
"serializer_view": {
"type": "string",
"enum": [
"normal",
"android",
"mobile",
"mobile_feed",
"prostore_file",
"ids_only"
],
"description": "The data set that should be returned from the serializer.\nThe normal view includes default fields, plus links, comments_count, trades.\nThe android view includes default fields, plus trades, comments.\nThe mobile view include default fields, plus log_date, trades, comments.\nThe mobile_feed view includes default fields, plus comments.\nThe prostore_file view includes default fields, plus images.\nThe ids_only view does not include default fields, response returns strictly an array of image ids.\nDefault view is normal."
}
},
"additionalProperties": {
"type": [
"string",
"number",
"boolean",
"null"
]
},
"required": [
"project_id"
]
}
},
"required": [
"query"
],
"additionalProperties": false
},
"pagination": null,
"notes": [
"Return a list of all Images from a Project's Photo Album (Image Category).\n\nSee [Filtering on List Actions](https://developers.procore.com/documentation/filtering-on-list-actions) for information on using the filtering capabilities provided by this endpoint."
],
"unresolved": [
"No authorised Procore provider request has verified this operation."
],
"request": {
"parameters": [
{
"name": "Procore-Company-Id",
"in": "header",
"description": "Unique company identifier associated with the Procore User Account.",
"required": true,
"schema": {
"type": "integer"
}
},
{
"name": "project_id",
"in": "query",
"required": true,
"description": "Unique identifier for the project.",
"schema": {
"type": "integer"
}
},
{
"name": "image_category_id",
"in": "query",
"description": "Optional. ID of the image category to filter the images by.",
"required": false,
"schema": {
"type": "integer"
}
},
{
"name": "page",
"in": "query",
"description": "Page",
"schema": {
"type": "integer"
}
},
{
"name": "per_page",
"in": "query",
"description": "Elements per page",
"schema": {
"type": "integer"
}
},
{
"example": [
123456
],
"name": "filters[daily_log_segment_id]",
"in": "query",
"description": "Daily Log Segment ID filter",
"schema": {
"type": "array",
"items": {
"type": "integer"
}
}
},
{
"name": "filters[log_date]",
"in": "query",
"required": false,
"description": "Date of Photos added to the Daily Log in the format \"YYYY-MM-DD\", or a range of dates in the format \"YYYY-MM-DD...YYYY-MM-DD\".",
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "filters[private]",
"in": "query",
"description": "If true, returns only item(s) with a `private` status.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "filters[starred]",
"in": "query",
"description": "If true, returns only item(s) with a `starred` status. This will be ignored for users without permission to star photos, returning the unfiltered list rather than an error.",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "filters[location_id]",
"in": "query",
"description": "Location ID. Returns item(s) with the specified Location ID or a range of Location IDs.",
"required": false,
"style": "form",
"explode": false,
"schema": {
"type": "array",
"items": {
"type": "integer",
"example": 45
}
}
},
{
"name": "filters[include_sublocations]",
"in": "query",
"description": "Use together with `filters[location_id]`\n",
"schema": {
"type": "boolean",
"default": false
}
},
{
"name": "filters[trade_ids]",
"in": "query",
"description": "Array of Trade IDs. Returns item(s) with the specified Trade IDs.",
"style": "form",
"explode": false,
"schema": {
"type": "array",
"items": {
"type": "integer"
}
}
},
{
"name": "filters[projection]",
"in": "query",
"description": "Return items with the specified projection type.",
"required": false,
"schema": {
"type": "string",
"enum": [
"360",
"regular"
]
}
},
{
"name": "filters[query]",
"in": "query",
"description": "Return item(s) containing search query",
"schema": {
"type": "string"
}
},
{
"name": "filters[created_at]",
"in": "query",
"description": "Return item(s) created within the specified ISO 8601 datetime range.\nFormats:\n`YYYY-MM-DD`...`YYYY-MM-DD` - Date\n`YYYY-MM-DDTHH:MM:SSZ`...`YYYY-MM-DDTHH:MM:SSZ` - DateTime with UTC Offset\n`YYYY-MM-DDTHH:MM:SS+XX:00...`YYYY-MM-DDTHH:MM:SS+XX:00` - Datetime with Custom Offset",
"required": false,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "filters[updated_at]",
"in": "query",
"description": "Return item(s) last updated within the specified ISO 8601 datetime range.\nFormats:\n`YYYY-MM-DD`...`YYYY-MM-DD` - Date\n`YYYY-MM-DDTHH:MM:SSZ`...`YYYY-MM-DDTHH:MM:SSZ` - DateTime with UTC Offset\n`YYYY-MM-DDTHH:MM:SS+XX:00`...`YYYY-MM-DDTHH:MM:SS+XX:00` - Datetime with Custom Offset",
"required": false,
"schema": {
"type": "string",
"format": "date"
}
},
{
"name": "filters[uploader_id]",
"in": "query",
"description": "Return item(s) uploaded by the specified User IDs",
"style": "form",
"explode": false,
"schema": {
"type": "array",
"items": {
"type": "integer"
}
}
},
{
"name": "filters[id]",
"in": "query",
"description": "Return item(s) with the specified IDs.",
"required": false,
"style": "form",
"explode": false,
"schema": {
"type": "array",
"items": {
"type": "integer"
}
}
},
{
"name": "sort",
"in": "query",
"description": "Field to sort by. If the field is passed with a - (EX: -created_at) it is sorted in reverse order",
"schema": {
"type": "string",
"enum": [
"deleted_at",
"created_at",
"exposure_date",
"taken_at",
"most_recent"
]
}
},
{
"name": "serializer_view",
"in": "query",
"description": "The data set that should be returned from the serializer.\nThe normal view includes default fields, plus links, comments_count, trades.\nThe android view includes default fields, plus trades, comments.\nThe mobile view include default fields, plus log_date, trades, comments.\nThe mobile_feed view includes default fields, plus comments.\nThe prostore_file view includes default fields, plus images.\nThe ids_only view does not include default fields, response returns strictly an array of image ids.\nDefault view is normal.",
"required": false,
"schema": {
"type": "string",
"enum": [
"normal",
"android",
"mobile",
"mobile_feed",
"prostore_file",
"ids_only"
]
}
}
],
"content": {}
},
"responseContentTypes": [
"application/json"
],
"provenance": {
"sourceUrl": "https://developers.procore.com/api/v1/resource_groups/resource/images?version=rest_v1.0",
"sourceSha256": "84469264df7544710210e68a3f16fe93fab8bec3d9fe4f9b275c3fc2b02914e3",
"snapshot": "snapshots/oas/images--rest_v1.0.json.gz"
},
"sourceCorrections": []
}The Unleashed waitlist is open. Inspect its documented coverage and account requirements.
Explore Unleashed