---
title: "Map (geocode) a batch of workspace addresses for Nearby — on demand"
description: "Admin-only, because each address is a BILLED Google Geocoding call (~$5 per 1,000), charged once per address and then cached forever. There is deliberately no scheduled job; an operator triggers this. Capped at MAX_PER_REQUEST per call so the request finishes inside gateway timeouts — the response reports `remaining` so the caller can simply call again. Idempotent: addresses already mapped, or already known unplaceable, are skipped and never re-billed.\n"
---

> Documentation Index
> Fetch the complete documentation index at: https://developer.channelautomations.com/llms.txt
> Use this file to discover all available pages before exploring further.

Path: Channel Automation API › Contacts

`POST /api/nearby-appointments/backfill`

Admin-only, because each address is a BILLED Google Geocoding call (~$5 per 1,000), charged once per address and then cached forever. There is deliberately no scheduled job; an operator triggers this. Capped at MAX_PER_REQUEST per call so the request finishes inside gateway timeouts — the response reports `remaining` so the caller can simply call again. Idempotent: addresses already mapped, or already known unplaceable, are skipped and never re-billed.

## Code samples

### cURL

```bash
curl --request POST \
  --url https://api.channelautomation.com/api/nearby-appointments/backfill
```

### TypeScript

```typescript
const url = 'https://api.channelautomation.com/api/nearby-appointments/backfill';
const options = {method: 'POST'};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://api.channelautomation.com/api/nearby-appointments/backfill"

response = requests.post(url)

print(response.text)
```

## Responses

### 200

{ attempted, geocoded, unresolvable, remaining, aborted }

### 403

Admin (JWT) authentication required.

### 404

Feature flag disabled.


Source: https://developer.channelautomations.com/api/post-api-nearby-appointments-backfill/index.md