GET/v1/listings

Listings

Public search and your own listings.

Search published listings

curl "https://api.ajungem.ro/v1/listings?category=freight&fromCountry=DE&toCountry=RO&limit=20"

Query parameters: category (car, move, parcel, freight), fromCountry, toCountry (ISO country code, 2 letters), dateFrom, dateTo (YYYY-MM-DD), weightMax (kg), volumeMax (m³), truckTypes (comma-separated), limit, cursor.

assistance (roadside assistance) doesn't appear here: it's a dedicated flow, site-only.

Output: ref, category, fromCity, fromCountry, toCity, toCountry, dateType, dateFrom, dateTo, description, budget, currency, urgent, needsInvoice, paymentDays, weightKg, volumeM3, truckTypes, status, createdAt, expiresAt, estimatedCost, distanceKm, url. See the Listing object.

A listing, by its code

curl https://api.ajungem.ro/v1/listings/7J769R

Public projection for anyone. If you're the owner or the chosen carrier, you also get transportStage and stageUpdatedAt — send a key to see them.

404 not_found for a code that doesn't exist.

Your listings

curl https://api.ajungem.ro/v1/listings/mine \
  -H "Authorization: Bearer ajk_live_…"

Requires the listings:read permission (any new key has it). Returns the listings published by the account behind the key — not the whole company's: a listing belongs to the person who published it, not their company.

🛠️

POST /listings, POST /listings/{ref}/cancel and POST /listings/{ref}/stage are planned for batch 2. Publish from the site or through the MCP server for now.