# Track Ukrposhta — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track parcels sent through Ukrposhta by looking up individual shipments or monitoring multiple packages at once to get real-time delivery status and tracking information. Access detailed tracking page metadata to stay informed about your parcels' locations and delivery progress.

**Category:** Other | **Website:** [track.ukrposhta.ua/](https://track.ukrposhta.ua/) | **Docs:** [parse.bot/marketplace/c10d653e-b6d5-4a07-b4ea-81a421befd05/track-ukrposhta-ua-api](https://parse.bot/marketplace/c10d653e-b6d5-4a07-b4ea-81a421befd05/track-ukrposhta-ua-api)

Pay-per-use API proxy for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/track-ukrposhta/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## Endpoints

### Get tracking page

Get the URL and metadata for the Ukrposhta tracking web interface. Returns a static response with the tracking page URL for the specified language. No network call to the site is made.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `lang` | string | No | Language for the page. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/track-ukrposhta/get-tracking-page \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"lang":"<string>"}'
```

### Track multiple parcels

Track multiple parcels simultaneously by providing a comma-separated list of barcodes. Uses the same tracking API as track_parcel but accepts multiple barcodes in one request. Returns a result object with tracking data or a message when shipments are not found.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `barcodes` | string | Yes | Comma-separated tracking numbers (e.g. CV102717070UA,0500500505098). |
| `lang` | string | No | Language for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/track-ukrposhta/track-multiple-parcels \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"barcodes":"<string>","lang":"<string>"}'
```

### Track parcel

Track a single parcel by its barcode. Returns origin/destination cities, tracking event history, and timestamp. Solves reCAPTCHA internally to access the Ukrposhta tracking API. Empty results or missing city data indicate the parcel has been fully delivered or the barcode is not recognized.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `barcode` | string | Yes | The tracking number (e.g. CV102717070UA or 0500500505098). |
| `lang` | string | No | Language for results. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/credits/track-ukrposhta/track-parcel \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"barcode":"<string>","lang":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.