# PostNL Shipment API v4

**Canonical:** https://apis.io/apis/postnl/shipment-api/  
**Provider:** PostNL — https://apis.io/providers/postnl/  
**Base URL:** https://api.postnl.nl  
**Documentation:** https://developer.postnl.nl/integration-with-postnl/api-overview/shipment-v4/

PostNL Shipment API v4 is one of 12 APIs that [PostNL](https://apis.io/providers/postnl/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Shipping, Labels, and Returns. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

The future-proof (v4) PostNL Shipment API: create barcodes, labels, label-and-confirm shipments, confirm shipments, generate return shipments, and look up delivery timeframes and pickup locations under /shipment/delivery/v4.

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| POST | `/shipment/delivery/v4/barcode` | Create barcodes |
| POST | `/shipment/delivery/v4/confirm` | Confirm shipment |
| POST | `/shipment/delivery/v4/label` | Create label |
| POST | `/shipment/delivery/v4/locations/near-coordinates` | Get available locations |
| POST | `/shipment/delivery/v4/locations/lookup` | Get location status and details |
| POST | `/shipment/delivery/v4/locations/near-address` | Get available locations |
| POST | `/shipment/delivery/v4/return/generate` | Create return shipment |
| POST | `/shipment/delivery/v4/labelconfirm` | Create shipment |
| POST | `/shipment/delivery/v4/timeframe/multipleservices` | Get available delivery dates and time windows for multiple services |
| POST | `/shipment/delivery/v4/timeframe/singleservice` | Get available delivery dates and time windows |

## Machine-readable artifacts (9)

- **OpenAPI** — https://artifacts.apis.io/postnl/openapi/postnl-shipment-api-openapi.yml
- **Documentation** — https://developer.postnl.nl/integration-with-postnl/api-overview/shipment-v4/
- **JSONSchema** — https://artifacts.apis.io/postnl/json-schema/postnl-shipment-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/postnl/json-schema/postnl-create-barcodes-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/postnl/json-schema/postnl-confirm-shipment-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/postnl/json-schema/postnl-pickup-near-coordinates-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/postnl/json-schema/postnl-services-delivery-date-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/postnl/json-schema/postnl-pickup-near-address-request-schema.json
- **APIsJSON** — https://artifacts.apis.io/postnl/apis.yml

## Other PostNL APIs (11)

- [PostNL Barcode API](https://apis.io/apis/postnl/barcode-api/)
- [PostNL Confirming API](https://apis.io/apis/postnl/confirming-api/)
- [PostNL Labelling API](https://apis.io/apis/postnl/labelling-api/)
- [PostNL Shipping Status API](https://apis.io/apis/postnl/shippingstatus-api/)
- [PostNL Checkout API](https://apis.io/apis/postnl/checkout-api/)
- [PostNL Checkout Postalcode Check API](https://apis.io/apis/postnl/postalcode-check-api/)
- [PostNL Deliverydate API](https://apis.io/apis/postnl/deliverydate-api/)
- [PostNL Locations API](https://apis.io/apis/postnl/locations-api/)
- [PostNL Timeframes API](https://apis.io/apis/postnl/timeframes-api/)
- [PostNL Consigments API](https://apis.io/apis/postnl/postnl-consigments-api/)
- [PostNL Address API](https://apis.io/apis/postnl/postnl-address-api/)

## Tags

Shipping, Labels, Returns

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/postnl/shipment-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/postnl/.