TradeNexusMarket

API v1

Cookie session after POST /api/v1/auth/login. Machine-readable spec: openapi.json. Deal room chat is a WebSocket at /ws on the same origin; the session cookie is sent with the handshake.

MethodPathWhat it does
GET/api/v1/healthHealth check
GET/api/v1/openapi.jsonThis document
POST/api/v1/auth/registerCreate an account (step 1 of the membership application)
POST/api/v1/auth/email/send-codeSend a 6-digit email confirmation code
POST/api/v1/auth/email/verifyConfirm the email with the code
GET/api/v1/applications/meThe signed-in member's application
PATCH/api/v1/applications/meSave one wizard step ({ step, data })
POST/api/v1/applications/me/submitSign the declarations and submit for review
POST/api/v1/applications/me/past-dealsAdd a past deal (1 to 5)
DELETE/api/v1/applications/me/past-deals/{id}Remove a past deal
POST/api/v1/applications/me/referencesAdd a trade reference (up to 2)
DELETE/api/v1/applications/me/references/{id}Remove a trade reference
POST/api/v1/admin/documents/{id}/reviewApprove, reject or ask to re-upload one document
POST/api/v1/admin/companies/{id}/checksSanctions, video KYC, past performance and email checks
POST/api/v1/admin/past-deals/{id}/verifyMark a past deal verified
POST/api/v1/admin/references/{id}/verifyMark a trade reference verified
POST/api/v1/admin/expiry-sweepRun the document expiry sweep now (super admin)
POST/api/v1/auth/loginSign in
POST/api/v1/auth/logoutSign out
GET/api/v1/auth/meCurrent member
POST/api/v1/contactPublic contact form
GET/api/v1/categoriesCommodity categories
GET/api/v1/listingsSearch listings. Public responses hide seller identity.
POST/api/v1/listingsCreate a listing (verified company)
GET/api/v1/listings/{id}Listing detail
PATCH/api/v1/listings/{id}Update a listing and store a version
GET/api/v1/rfqsList RFQs
POST/api/v1/rfqsPost an RFQ
GET/api/v1/rfqs/{id}RFQ detail
POST/api/v1/rfqs/{id}/quotesSeller quote on an RFQ
POST/api/v1/documentsUpload a private document (multipart)
GET/api/v1/documents/{id}Download a document the caller is allowed to see
GET/api/v1/companies/meOwn company, documents, verification status
GET/api/v1/dealsDeals visible to the caller
GET/api/v1/deals/{id}Deal room
GET/api/v1/deals/{id}/messagesDeal room messages
POST/api/v1/deals/{id}/messagesPost a message (emails and phones are masked)
POST/api/v1/deals/{id}/offersVersioned offer
POST/api/v1/deals/{id}/offers/{offerId}/acceptCounterparty accepts an offer
POST/api/v1/deals/{id}/offers/{offerId}/rejectCounterparty rejects an offer
POST/api/v1/deals/{id}/commission-ackAcknowledge the per-deal commission
POST/api/v1/deals/{id}/completeDeclare completion with evidence
POST/api/v1/deals/{id}/confirm-completionOther party confirms completion and invoices commission
POST/api/v1/deals/{id}/disputeOpen a dispute
POST/api/v1/deals/{id}/cancelCancel before acceptance, or admin cancel
GET/api/v1/invoicesInvoices for the caller's deals
GET/api/v1/notificationsIn-app notifications
POST/api/v1/reportsReport a fake member or a listing
POST/api/v1/match-requestsAsk the desk to match your listing or RFQ
GET/api/v1/blocksCompanies you have blocked
POST/api/v1/blocksBlock a company
DELETE/api/v1/blocks/{companyId}Unblock a company
GET/api/v1/admin/verificationVerification queue
GET/api/v1/admin/verification/{id}Verification case with documents
POST/api/v1/admin/verification/{id}/decisionApprove, reject, or request more info
GET/api/v1/admin/matchesMatch-request queue and scored suggestions
POST/api/v1/admin/dealsApprove a match and enter that deal's commission rate. The room opens after both sides accept the agreement.
PATCH/api/v1/admin/deals/{id}/commissionSet the commission rate on a deal. Not shown to members.
POST/api/v1/admin/companies/{id}/suspensionBlock or restore a company
GET/api/v1/admin/commissionsPolicies, ledger, invoices
PATCH/api/v1/admin/policies/{id}Update a commission policy
POST/api/v1/admin/invoices/{id}/paymentsRecord an off-platform commission payment
GET/api/v1/admin/moderationOpen reports and disputes
POST/api/v1/admin/moderation/{id}/resolveResolve a report
POST/api/v1/admin/listings/{id}/moderateFlag, close, or restore a listing
POST/api/v1/admin/categoriesCreate a category
PATCH/api/v1/admin/categories/{id}Update a category
GET/api/v1/admin/auditAudit log
GET/api/v1/admin/inquiriesContact form inquiries
GET/api/v1/admin/jobsBackground job counts