# How much does PickPoint geocoding, address search and routing cost?

Geocoding, Address Search and Routing on PickPoint's agent storefront all cost the same: $0.25 per thousand requests, with no subscription. Each call draws on a plan your credential holds: either the Free trial ($0.625, 2,500 requests, once per human with a verified email) or Pay as you go credit bought from $0.01 ($0.50 by card). Start with [the buyer skill](https://agents.pickpoint.io/zcj/u5ue9k3allrj/SKILL.md), send each call to `https://agents.pickpoint.io/zcj/u5ue9k3allrj` with `Authorization: Bearer <token>`, and read the charge in the `zc-billing` response header.

## At a glance

- **Rate:** the same for all three services: $0.25 per thousand requests. One request costs $0.00025.
- **Unit:** each call is one request. This covers forward and reverse geocoding, address search, lookup, routes, optimized routes and locate.
- **Plans:** the Free trial ($0.625 of credit, 2,500 requests, one per human, verified email required), or Pay as you go prepaid credit from $0.01 on a wallet rail and $0.50 by card. There is no subscription.
- **Buying credit:** `POST https://agents.pickpoint.io/zcj/u5ue9k3allrj/plans/{planId}/purchase`. Plan ids are in `https://agents.pickpoint.io/zcj/u5ue9k3allrj/manifest.json`. The purchase answers a 402, which is the price quote: you pay it and retry. You can pay over x402 (Base USDC), MPP (Tempo USDC) or by card.
- **Calling:** send `Authorization: Bearer <token>`. The bearer credential is the agent identity the storefront issues.
- **Charge per call:** the `chargedUsd` field of the `zc-billing` response header.
- **Full purchase flow:** [the buyer skill](https://agents.pickpoint.io/zcj/u5ue9k3allrj/SKILL.md)

## Cost of common workloads

| Workload | Requests | Cost |
| --- | --- | --- |
| One geocode, search or route | 1 | $0.00025 |
| 1,000 geocodes | 1,000 | $0.25 |
| 100,000 geocodes | 100,000 | $25 |
| Address form: ten keystrokes, then a route | 11 | $0.00275 |

An address form that searches on each keystroke sends one Address Search request per keystroke. Ten keystrokes and the route to the chosen address therefore make eleven requests.

## Read the charge on each call

Every call uses the same request shape:

```http
GET https://agents.pickpoint.io/zcj/u5ue9k3allrj/v2/geocode/forward?q=Texas+State+Capitol,+Austin&format=json&limit=1&addressdetails=1
Authorization: Bearer <token>
```

A call funded from credit returns the charge in a header:

```
zc-billing: {"status":"settled","fundingSource":"credit","chargedUsd":"<amount debited>"}
```

Example charges:

- A forward geocode for the Texas State Capitol drew $0.00025 from credit.
- An address search for the partial query `Golden Gate Bri` with `limit=3` returned three candidates and drew $0.00025 from credit.
- A driving route (`POST /v2/route`, `costing` set to `auto`) from the Texas State Capitol to Zilker Park drew $0.00025 from credit.

## What is charged, and when

- Reading the catalog and the API reference needs no credential and no payment.
- A call without a credential answers `401 bearer_required`. A credential with no covering plan answers `403 plan_required`, and the response lists the plans that cover the call.
- Credit purchases and top-ups are paid by settling their 402. The Free trial is claimed with no payment. Calls draw down the balance.
- When credit runs out, calls answer `usage_exhausted`. Add credit with `POST /extend`. Unused credit stays on the balance.
- A delivered response with no `zc-billing` header billed nothing.

## Frequently asked questions

### Is there a PickPoint free trial?

Yes. The Free trial grants $0.625 of credit, enough for 2,500 requests across Geocoding, Address Search and Routing. Each human can claim it once, with no payment. The trial needs a credential tied to your human's verified email; until it is, the claim answers `403 verified_email_required`. You claim the trial with `POST /plans/{planId}/purchase`, an empty body and your bearer.

### What do 1,000 geocoding requests cost?

1,000 geocoding requests cost $0.25. Reverse geocoding, address search, lookup and routing calls cost the same per request, so 1,000 calls of any mix also cost $0.25.

### How are requests counted?

Each call is one request. A lookup call takes up to 50 OpenStreetMap ids and is still one request.

### Is there a monthly fee or subscription?

No. Pay as you go is prepaid credit with no billing interval. You buy it from $0.01 on x402 or MPP, or from $0.50 by card, and calls draw it down until you top it up.

## Keep reading

- [The buyer skill](https://agents.pickpoint.io/zcj/u5ue9k3allrj/SKILL.md): the full purchase flow
- [Machine catalog](https://agents.pickpoint.io/zcj/u5ue9k3allrj/manifest.json): live plans, prices and purchase URLs
- [How to pay](https://agents.pickpoint.io/zcj/u5ue9k3allrj/payment.md): the 402 and each payment rail
- [Identity](https://agents.pickpoint.io/zcj/u5ue9k3allrj/auth.md): registering and claiming a credential
- [Error reference](https://agents.pickpoint.io/zcj/u5ue9k3allrj/errors.md): every error code and what to do

---

Updated 2026-11-06. All PickPoint guides: https://agents.pickpoint.io/guides.md. Storefront: https://agents.pickpoint.io/zcj/u5ue9k3allrj/llms.txt.
