GET/v1/runs/next

Next planned production runs

Per product group: the next planned cutoff (Europe/Amsterdam), the expected handover week, the processing and carrier lead time and the earliest expected delivery date. Items released before the cutoff travel with that run.

Scope templates.read

Query parameters

productGroupstringmin length 1max length 60

Responses

200Success

401Authentication required or API key invalid

403Permission or scope missing, organisation suspended

422Validation failed

429Rate limited for this API key and class; wait Retry-After seconds

otherError (RFC 9457 problem details)

Request

curl https://api.postbuddy.nl/v1/runs/next \
  -H "Authorization: Bearer $POSTBUDDY_API_KEY"

import { PostBuddyClient } from '@postbuddy/sdk';

const client = new PostBuddyClient({ apiKey: process.env.POSTBUDDY_API_KEY! });

const result = await client.runs.next();

import os
from postbuddy import Client

client = Client(os.environ["POSTBUDDY_API_KEY"])

result = client.runs.next()

Response

[
  {
    "productGroup": "Example",
    "run": {
      "id": "run_01J9Y2K8QF4T6W8Z0B2D4F6H8K",
      "cutoffAt": "2026-10-16T09:14:02.000Z",
      "handoverWeek": "Example",
      "handoverMonday": "2026-11-02"
    },
    "carrierLeadTimeDays": 1,
    "processingDays": 1,
    "leadTimeDays": 1,
    "expectedDeliveryFrom": "2026-11-02"
  }
]

{
  "type": "https://docs.postbuddy.nl/errors/validation_failed",
  "title": "Validation failed",
  "status": 422,
  "code": "validation_failed",
  "detail": "Validation failed",
  "requestId": "req_01J9Y2K8QF4T6W8Z0B2D4F6H8K",
  "errors": [
    {
      "field": "recipient.postalCode",
      "code": "invalid_string",
      "message": "Invalid postal code"
    }
  ]
}