BringEasy Agent API
BringEasy is a marketplace for used furniture, appliances, bikes and other large things in Berlin: you buy a piece and book the transport with it, or you book only the transport for something you bought elsewhere. Self-employed drivers pick it up and bring it into your flat.
Read-only endpoints for software that shops on a human's behalf. Two promises hold everywhere: the disclosure is exactly what the public pages show, and every money figure comes from the pricing engine. Checkout itself requires a human: payment carries Strong Customer Authentication and the consent record is a human action, so the intended division of labour is that an agent finds, compares and assembles, and its human confirms and pays.
Endpoints
GET /api/agent/listingsActive listings, newest first. Query: limit (max 100), offset. Every field mirrors the public listing page; prices are integer cents.
GET /api/agent/listings/{id}One listing plus its concrete bookable pickup windows. The windows come from the same availability engine and the same payment-horizon cap as the human picker, so no date is offered that a booking would refuse. 410 when the listing is no longer active.
GET /api/agent/tariffThe transport tariff as machine-readable terms, re-exported from the pricing engine. Estimate any Berlin collection from these; the suggestion is made at booking from the exact facts, the buyer may add one of boostStepsCents to it (never below it, never beyond offerBand), and the settled figure is itemised before payment.
GET /api/agent/vocabularyEvery machine-readable refusal code a booking flow can answer with, plus the German and English sentences the product shows a human for the same code.
The transport tariff
Live values, identical to /api/agent/tariff:
{
"currency": "EUR",
"tariff": "tarif-2",
"vehicles": {
"van": {
"baseCents": 4500,
"perKmCents": 160,
"minimumCents": 5900
},
"large": {
"baseCents": 6600,
"perKmCents": 180,
"minimumCents": 7900
}
},
"pieceSizes": {
"S": {
"underKg": 10,
"underM3": 0.15
},
"M": {
"underKg": 25,
"underM3": 0.6
},
"L": {
"underKg": 60
},
"XL": {
"fromKg": 60
}
},
"loadingCentsPerPiece": {
"S": 200,
"M": 300,
"L": 600,
"XL": 800
},
"stairsCentsPerPiecePerFloorWithoutLift": {
"S": 100,
"M": 200,
"L": 500,
"XL": 500
},
"stairsMinimumCentsPerFloor": 500,
"extraPickupCents": 1000,
"storeDeskCents": 1000,
"storeDeskApplies": "At a known store (IKEA, Höffner, POCO) always; at another shop only when the driver carries the piece out. Another shop with the piece ready at the street is priced as any pickup at the street, without it.",
"aloneCarryPerPlaceCents": 1000,
"streetPerPlaceOffCents": 500,
"farTripCents": 1304,
"minimumTransportCents": 5900,
"secondPerson": {
"baseCents": 3500,
"stairsCentsPerPiecePerFloor": {
"L": 300,
"XL": 300
},
"minimumCentsPerFloor": 300,
"minimumCentsPerFloorWithXl": 300
},
"helperBaseCents": 3500,
"helperPerFloorCents": 300,
"helperPerHeavyFloorCents": 300,
"heavyPieceKg": 60,
"boostStepsCents": [
500,
1000,
2000
],
"byTheHour": {
"driverWithVanPerHourCents": 4500,
"personPerHourCents": 2500,
"approachCents": 2000,
"minHours": 1.5
},
"kitchenWork": {
"takingApartPerPartCents": 1500,
"takingApartMinimumCents": 15000,
"fittingPerPartCents": 3500,
"fittingMinimumCents": 25000
},
"offerBand": {
"lowestShareOfSuggestion": 1,
"highestShareOfSuggestion": 2
},
"notes": [
"Transport within Berlin, Potsdam and the towns right next to Berlin. A trip to or from Potsdam or Bernau adds 1304 cents to the transport once (1500 cents with the service fee), for the driver's drive back.",
"One tariff for every delivery: a listing bought on the marketplace, a trip with several sellers and a transport booked on its own are priced by the same terms for the same pieces, doors and distance.",
"Transport = max(base + per km x km + loading per piece + stairs per piece and floor, minimum) + extra pickups + a store desk + fixed work + each extra person + a trip to or from Potsdam or Bernau + aloneCarryPerPlaceCents for each place (the pickups one, the delivery the other) where the driver carries alone; base and minimum are streetPerPlaceOffCents lower for each place where the piece waits at the street. The km are the straight line between the doors, every km from the first, rounded to whole euros.",
"A small move and a fitted kitchen's transport (listed or booked) are priced by the hours the job takes instead (byTheHour): the driver with the van and each extra person for the estimated hours, plus the way there once; a kitchen comes with two people, and its taking apart and fitting are priced per part on top (kitchenWork).",
"On a single listing the buyer may add one of boostStepsCents to the suggestion, never go below it; what they settle on is charged and paid to the driver. The price of an extra person does not move. minimumTransportCents is the lowest suggestion.",
"A seller helping at their own door takes that door's floors off the extra person's price. Help at a door decides whether an extra person is needed at all; where nobody helps and no extra person comes, the driver carries alone there and aloneCarryPerPlaceCents is added for that place.",
"Item price, transport and the service fee are itemised before payment."
]
}Structured data
Every listing page carries schema.org Product JSON-LD with the item's price. The transport price is not in it: it depends on the buyer's door, and on a listing the buyer may move BringEasy's suggestion (see the tariff's offerBand). The catalogue is enumerated in https://www.bringeasy.de/sitemap.xml and summarised for language models in https://www.bringeasy.de/llms.txt.
Fair use
These endpoints exist to be read by software, including yours. Be identifiable in your User-Agent, cache what does not change, and treat the refusal vocabulary as the contract it is: a 4xx booking response names its reason with a code from /api/agent/vocabulary.