API v1

REST API used by the website itself. JSON responses { ok, message, ... } or errors { error, code, fields } with proper HTTP codes (400 validation, 401, 403 RBAC, 404, 409 business rule, 422, 429 rate limit). Mutations require the X-CSRF-Token header (value of the ap_csrf cookie). OpenAPI spec: /openapi.json.

Real-time: Socket.IO at /socket.io · client events join {lotId|eventId}, sync, bid {lotId, amountCents, idempotencyKey} · server events lot:update, lot:closed, event:update, notification.

Auth & account

MethodPathDescriptionAccess
POST/api/v1/auth/registerCreate account (step 1)public
POST/api/v1/auth/loginSign in (buyer/seller mode)public
POST/api/v1/auth/logoutSign outuser
GET/api/v1/auth/meCurrent userpublic
POST/api/v1/auth/forgot-passwordRequest reset linkpublic
POST/api/v1/auth/reset-passwordReset password with tokenpublic
POST/api/v1/auth/change-passwordChange passworduser
POST/api/v1/memberships/chooseChoose membership (creates invoice if paid)buyer
POST/api/v1/documentsUpload verification document (multipart)user
PATCH/api/v1/profileUpdate profileuser

Catalog & search

MethodPathDescriptionAccess
GET/api/v1/makesMakes with modelspublic
GET/api/v1/makes/:id/modelsModels of a makepublic
GET/api/v1/vehicle-typesVehicle typespublic
GET/api/v1/damage-typesDamage typespublic
GET/api/v1/locationsYardspublic
GET/api/v1/lots?q&make&model&type&condition&year_from&year_to&odo_min&odo_max&location&damage&status&sort&page&per_pagePaginated lot searchpublic
GET/api/v1/lots/:lotNumberLot detail + bid historypublic
GET/api/v1/auctionsAuction eventspublic
GET/api/v1/fees/estimate?amount=Cost calculatorpublic

Bidding (also via WebSocket event "bid")

MethodPathDescriptionAccess
POST/api/v1/lots/:id/bidsPre-bid / live bid. Body {amount, idempotency_key}bids.place
POST/api/v1/watchlist/:lotIdToggle watchlistuser
POST/api/v1/saved-searchesSave searchuser
DELETE/api/v1/saved-searches/:idDelete saved searchuser

Alerts & support

MethodPathDescriptionAccess
POST/api/v1/alertsCreate vehicle alertpublic
PATCH/api/v1/alerts/:tokenEdit alerttoken
POST/api/v1/alerts/:token/cancelCancel alerttoken
POST/api/v1/support/ticketsContact formpublic

Orders, payments, transport, pickup

MethodPathDescriptionAccess
POST/api/v1/invoices/:id/payments/demoDemo payment (bank transfer + receipt, or sandbox card)owner
POST/api/v1/payments/:id/reviewApprove/reject paymentfinance.review
POST/api/v1/orders/:id/cancelCancel unpaid orderfinance.review
POST/api/v1/transport/estimatePublic transport estimatepublic
POST/api/v1/orders/:id/transport-quotesQuote for a purchaseowner
POST/api/v1/transport/quotes/:id/acceptAccept quote → transport order + invoiceowner
POST/api/v1/transport-orders/:idUpdate transport statuslogistics.manage
POST/api/v1/pickup-passes/validateValidate pickup PINpickup.validate

Seller

MethodPathDescriptionAccess
POST/api/v1/seller/applyApply as selleruser
POST/api/v1/seller/vehiclesCreate draftvehicles.sell
PATCH/api/v1/seller/vehicles/:idEdit draftvehicles.sell
DELETE/api/v1/seller/vehicles/:idDelete draftvehicles.sell
POST/api/v1/seller/vehicles/:id/submitSubmit for approvalvehicles.sell
POST/api/v1/seller/vehicles/:id/imagesUpload photos (multipart)vehicles.sell
POST/api/v1/seller/vehicles/:id/documentsUpload documentvehicles.sell
POST/api/v1/seller/lots/:id/decisionAccept/reject bid below reservevehicles.sell

Administration

MethodPathDescriptionAccess
PATCH/api/v1/admin/users/:idStatus, roles, plan, verificationusers.manage
POST/api/v1/admin/usersCreate userusers.manage
POST/api/v1/admin/documents/:id/reviewApprove/reject documentdocuments.review
POST/api/v1/admin/sellers/:id/approveApprove sellerusers.manage
POST/api/v1/admin/vehicles/:id/reviewApprove (assign to auction) / rejectvehicles.approve
POST/api/v1/admin/eventsSchedule auctionauctions.manage
POST/api/v1/admin/events/:id/startStart auction nowauctions.manage
POST/api/v1/admin/events/:id/cancelCancel auctionauctions.manage
PATCH/api/v1/admin/lots/:idEdit lot pricesauctions.manage
PATCH/api/v1/admin/plans/:idEdit membership limitssettings.manage
PATCH/api/v1/admin/settings/:keyEdit settingsettings.manage
POST/api/v1/admin/catalog/:kindCreate make/model/type/damagecatalog.manage
POST/api/v1/admin/locationsCreate yardlocations.manage
PATCH/api/v1/admin/pages/:slugEdit content pagecontent.manage
GET/api/v1/reports/:name.csvExport CSV reportreports.view

Regístrese ahora para acceder a autos, camiones, SUV y más, usados y reparables, en subastas 100% en línea.

REGISTRARSE