---
title: "Create a country-specific points batch job"
method: POST
path: "/{country_code}/batch/points"
tags: ["Batch Operations"]
---

# Create a country-specific points batch job

`POST /{country_code}/batch/points`

## Request

- Base URL: `https://app.regrid.com/api/v2`
- URL: `https://app.regrid.com/api/v2/{country_code}/batch/points`
- Auth: one of:
  - API key in header `x-regrid-token`
  - API key in query parameter `token`

Same as batch/points but for a specific country code like 'ca' for Canada.
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.

## Path parameters

- `country_code` 'ca' | 'us', required

## Query parameters

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

## Request body

- GeojsonPointsRequest
  - `geojson` object: A GeoJSON Feature Collection containing GeoJSON Point Features
    - `type` 'FeatureCollection'
    - `features` object[]
      - `type` 'Feature'
      - `properties` object
        - `custom_id` string: Optional identifier to track each point
      - `geometry` object
        - `type` 'Point'
        - `coordinates` number[]

## 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.dev/regrid/apis/regrid-batch-processing-api.md) - [All operations](https://skmtc.dev/regrid/apis/regrid-batch-processing-api/llms.txt) - [OpenAPI document](https://skmtc.dev/regrid/apis/regrid-batch-processing-api/revisions/f61328c3d7f5?raw)