---
title: "Submits a workflow for Bulk Spatial Operation"
method: POST
path: "/v1/spatial/bulk-operations"
tags: ["Bulk Analysis API"]
---

# Submits a workflow for Bulk Spatial Operation

`POST /v1/spatial/bulk-operations`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/spatial/bulk-operations`
- Auth: HTTP bearer

This API allows users to submit a workflow for bulk spatial operations such as Search Nearest, Search At Location, Overlaps, and Summarize. The request must include the necessary payload for the operation and returns a workflow url

## Headers

- `X-Request-Id` string

## Request body

- BulkOperationRequest
  - `operation` 'SEARCH_NEAREST' | 'SEARCH_AT_LOCATION' | 'OVERLAPS' | 'SUMMARIZE' | 'DATA_GRAPH_GET_BY_ID' | 'DATA_GRAPH_GET_BY_ADDRESS' | 'DATA_GRAPH_GET_BY_SPATIAL' | 'MULTIPASS' | 'ORDER_EXTRACTOR' | 'OTHER' | 'TRAVEL_BOUNDARY', required: Name of the bulk operations such as SEARCH_NEAREST, SEARCH_AT_LOCATION, OVERLAPS, SUMMARIZE, DATA_GRAPH_GET_BY_ID, DATA_GRAPH_GET_BY_ADDRESS, DATA_GRAPH_GET_BY_SPATIAL, MULTIPASS, TRAVEL_BOUNDARY and ORDER_EXTRACTOR
  - `payload` JsonNode, required

## Response `200`

Successfully submits a workflow.

- WorkflowSubmitResponse: Response containing the URI to check the status of the submitted workflow.
  - `statusUrl` string, uri: URI endpoint to poll for the workflow status.

## Other responses

- `400`: Invalid File Id
- `401`: Unauthorized: Invalid token
- `403`: Forbidden
- `429`: Too many requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/precisely/apis/bulk-orchestrator-apis.md) · [All operations](https://skmtc.dev/precisely/apis/bulk-orchestrator-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/bulk-orchestrator-apis/revisions/989567dcef87?raw)