---
title: "Create a points batch job"
method: POST
path: "/batch/points"
tags: ["Batch Operations"]
---

# Create a points batch job

`POST /batch/points`

Similar to the API v2 `parcels/point` endpoint. This endpoint receives a list of points in two forms: 
A standard CSV file upload, or the API v2 standard GeoJSON format containing a Feature Collection of Point Features. 
One can also include a `custom_id` value to track whether each point has a parcel match in the results.
This custom ID does not have to be unique. Letters and numbers are allowed.

## Query parameters

- `callback_url` string
- `return_geometry` boolean
- `radius` integer
- `return_stacked` boolean
- `return_custom` boolean
- `return_field_labels` boolean
- `return_custom_id` boolean

## Response `202`

Batch job created successfully

- BatchJobCreated
  - `message` string
  - `job_uuid` string, uuid
  - `status` 'queued'

## Other responses

- `400` — Bad request. Invalid input parameters.
- `401` — Unauthorized. Invalid API token.
- `413` — Payload too large. Maximum allowed is 50MB or 100,000 points.

---

[API](https://skmtc.net/regrid/apis/regrid-openapi-specification.md) · [All operations](https://skmtc.net/regrid/apis/regrid-openapi-specification/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/regrid/regrid-openapi-specification/versions/e4abb9a7fcfe/schema)