{"openapi":"3.1.0","info":{"title":"Cargo World Connect Public API","version":"1.0.0","description":"REST API for schedules, buying-lead teasers, provider directory, and master data. Authenticated seeker/provider actions use the Cargo World Connect app with OAuth.","contact":{"name":"Cargo World Connect","email":"sales@cargoworldconnect.com","url":"https://freight-marketplace-platform-landin.vercel.app/developers"}},"servers":[{"url":"https://api.cargoworldconnect.com/api/v1","description":"Production API v1"}],"tags":[{"name":"health","description":"Availability"},{"name":"schedules","description":"Published sailings"},{"name":"queries","description":"Public RFQ teasers"},{"name":"companies","description":"Provider directory"},{"name":"master-data","description":"Ports and reference data"}],"paths":{"/health":{"get":{"tags":["health"],"summary":"API health check","operationId":"getHealth","responses":{"200":{"description":"Service is healthy"}}}},"/schedules/public":{"get":{"tags":["schedules"],"summary":"List public service schedules (teaser)","operationId":"listPublicSchedules","parameters":[{"name":"page","in":"query","schema":{"type":"integer","minimum":1}},{"name":"pageSize","in":"query","schema":{"type":"integer","maximum":50}}],"responses":{"200":{"description":"JSON response body","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/queries/teasers":{"get":{"tags":["queries"],"summary":"Browse public buying-lead teasers","operationId":"listQueryTeasers","parameters":[{"name":"page","in":"query","schema":{"type":"integer"}},{"name":"pageSize","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"JSON response body","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/companies/directory":{"get":{"tags":["companies"],"summary":"Search compliance-verified provider directory","operationId":"listDirectoryCompanies","parameters":[{"name":"q","in":"query","schema":{"type":"string"}},{"name":"city","in":"query","schema":{"type":"string"}},{"name":"page","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"JSON response body","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/companies/directory/{id}":{"get":{"tags":["companies"],"summary":"Provider profile by id","operationId":"getDirectoryCompany","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"JSON response body","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Company not found"}}}},"/master-data/ports":{"get":{"tags":["master-data"],"summary":"List ports for lane and query forms","operationId":"listPorts","parameters":[{"name":"q","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"JSON response body","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"externalDocs":{"description":"Developer discovery on the marketing site","url":"https://freight-marketplace-platform-landin.vercel.app/developers"},"x-discovery":{"apiCatalog":"https://freight-marketplace-platform-landin.vercel.app/.well-known/api-catalog","llmsTxt":"https://freight-marketplace-platform-landin.vercel.app/llms.txt"}}