# 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. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-track-ukrposhta-ua-api-c10d653e/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## 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/parse-track-ukrposhta-ua-api-c10d653e/get_tracking_page \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-track-ukrposhta-ua-api-c10d653e/track_multiple_parcels \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -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/parse-track-ukrposhta-ua-api-c10d653e/track_parcel \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"barcode":"<string>","lang":"<string>"}'
```