{"openapi":"3.1.0","info":{"title":"RescueCatalog agent API","version":"1.0.0","description":"RescueCatalog sells emergency, first-aid, rescue and aid kits to governments, aid organisations and companies, quoted per request. Use search_products / get_product to find products (refs RS-001…), search_aid_needs to see published aid-kit tenders worldwide, request_quote to ask for an offer (no account needed; the offer goes to the e-mail given) and get_request_status to follow up. Producers can offer capacity with submit_supplier_offer. Same tools as the MCP server at https://rescuecatalog.com/mcp and the A2A agent at https://rescuecatalog.com/a2a.","contact":{"email":"ag@brn.ai","url":"https://rescuecatalog.com/agents/"}},"servers":[{"url":"https://rescuecatalog.com/agents/api"}],"paths":{"/tools":{"get":{"operationId":"listTools","summary":"All tools with JSON input schemas","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/call":{"post":{"operationId":"callTool","summary":"Call any tool by name","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"tool":{"type":"string","enum":["search_products","get_product","list_product_categories","search_aid_needs","get_aid_need","list_aid_kit_types","get_ordering_info","request_quote","submit_supplier_offer","get_request_status"]},"arguments":{"type":"object"}},"required":["tool"]}}}},"responses":{"200":{"description":"Tool result: {ok:true, tool, result}"},"400":{"description":"{ok:false, error}"},"429":{"description":"Rate limit"}}}},"/products":{"get":{"operationId":"searchProducts","summary":"Search products","parameters":[{"name":"query","in":"query","required":false,"description":"Search words","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Category name or slug","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1–50)","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"integer"}},{"name":"lang","in":"query","required":false,"description":"Language code","schema":{"type":"string","enum":["en","ar","zh","es","fr","de","pt","ru","ja","ko","it","tr","nl","pl","uk","hi","id","fa","ur","vi"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/products/{ref}":{"get":{"operationId":"getProduct","summary":"Product details","parameters":[{"name":"ref","in":"path","required":true,"schema":{"type":"string"}},{"name":"lang","in":"query","required":false,"description":"Language code","schema":{"type":"string","enum":["en","ar","zh","es","fr","de","pt","ru","ja","ko","it","tr","nl","pl","uk","hi","id","fa","ur","vi"]}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/categories":{"get":{"operationId":"listCategories","summary":"Product categories","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/needs":{"get":{"operationId":"searchAidNeeds","summary":"Search aid-kit requests","parameters":[{"name":"query","in":"query","required":false,"description":"Search words","schema":{"type":"string"}},{"name":"kit_type","in":"query","required":false,"description":"Kit type id","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"Country","schema":{"type":"string"}},{"name":"status","in":"query","required":false,"description":"Open, Closed, Awarded, Unknown","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results","schema":{"type":"integer"}},{"name":"offset","in":"query","required":false,"description":"Offset","schema":{"type":"integer"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/needs/{id}":{"get":{"operationId":"getAidNeed","summary":"One aid-kit request","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/kit-types":{"get":{"operationId":"listAidKitTypes","summary":"Aid-kit types","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/ordering":{"get":{"operationId":"getOrderingInfo","summary":"How ordering works","parameters":[],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}},"/quote-requests":{"post":{"operationId":"requestQuote","summary":"Send a quote request","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/request_quote_input"}}}},"responses":{"201":{"description":"Received"},"400":{"description":"Invalid input"},"429":{"description":"Rate limit"}}}},"/supplier-offers":{"post":{"operationId":"submitSupplierOffer","summary":"Offer products or capacity","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/submit_supplier_offer_input"}}}},"responses":{"201":{"description":"Received"},"400":{"description":"Invalid input"},"429":{"description":"Rate limit"}}}},"/requests/{id}":{"get":{"operationId":"getRequestStatus","summary":"Status of a quote request or supplier offer","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"email","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Invalid input"},"404":{"description":"Not found"},"429":{"description":"Rate limit"}}}}},"components":{"schemas":{"search_products_input":{"type":"object","properties":{"query":{"type":"string","description":"Free-text search, any words: product type, item, size, material, ref (RS-123) …","maxLength":200},"category":{"type":"string","description":"Exact category name or slug from list_product_categories"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10},"offset":{"type":"integer","minimum":0,"default":0},"lang":{"type":"string","enum":["en","ar","zh","es","fr","de","pt","ru","ja","ko","it","tr","nl","pl","uk","hi","id","fa","ur","vi"],"description":"Language for names and texts (default en). Product texts exist in 20 languages."}},"additionalProperties":false},"get_product_input":{"type":"object","properties":{"ref":{"type":"string","description":"Product ref, e.g. RS-001","pattern":"^[Rr][Ss]-?\\d{1,3}$"},"lang":{"type":"string","enum":["en","ar","zh","es","fr","de","pt","ru","ja","ko","it","tr","nl","pl","uk","hi","id","fa","ur","vi"],"description":"Language for names and texts (default en). Product texts exist in 20 languages."}},"required":["ref"],"additionalProperties":false},"list_product_categories_input":{"type":"object","additionalProperties":false},"search_aid_needs_input":{"type":"object","properties":{"query":{"type":"string","description":"Free text: country, kit, item, request type …","maxLength":200},"kit_type":{"type":"string","description":"Kit type id from list_aid_kit_types, e.g. hygiene, dignity, nfi, shelter, winter, food, firstaid"},"region":{"type":"string","description":"Region name, e.g. Asia & Pacific"},"country":{"type":"string","description":"Country name, e.g. Sudan"},"status":{"type":"string","enum":["Open","Closed","Awarded","Cancelled","Unknown"],"description":"Request status"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10},"offset":{"type":"integer","minimum":0,"default":0}},"additionalProperties":false},"get_aid_need_input":{"type":"object","properties":{"id":{"type":"string","description":"Request id, e.g. RN-001","pattern":"^[Rr][Nn]-?\\d{1,4}$"}},"required":["id"],"additionalProperties":false},"list_aid_kit_types_input":{"type":"object","additionalProperties":false},"get_ordering_info_input":{"type":"object","additionalProperties":false},"request_quote_input":{"type":"object","properties":{"organization":{"type":"string","description":"Buying organisation (government body, NGO, company)","maxLength":200},"email":{"type":"string","format":"email","description":"Where the offer should go"},"contact_name":{"type":"string","maxLength":120},"phone":{"type":"string","maxLength":60},"country":{"type":"string","description":"Delivery country","maxLength":80},"delivery_location":{"type":"string","description":"City, port or warehouse","maxLength":200},"items":{"type":"array","maxItems":100,"description":"Catalogue products","items":{"type":"object","properties":{"ref":{"type":"string","description":"Product ref, e.g. RS-001"},"quantity":{"type":"integer","minimum":1,"maximum":100000000},"notes":{"type":"string","maxLength":500}},"required":["ref","quantity"]}},"custom_kit":{"type":"object","description":"A kit built to your own item list","properties":{"description":{"type":"string","maxLength":2000},"quantity":{"type":"integer","minimum":1,"maximum":100000000},"contents":{"type":"array","maxItems":200,"items":{"type":"string","maxLength":200},"description":"Item list, one item per entry, e.g. \"2 × emergency blanket 160×210 cm\""}},"required":["description","quantity"]},"needed_by":{"type":"string","description":"Date the goods are needed, YYYY-MM-DD","maxLength":40},"tender_reference":{"type":"string","maxLength":200},"budget_per_unit":{"type":"string","description":"Optional, e.g. \"EUR 30 per kit\"","maxLength":100},"notes":{"type":"string","maxLength":4000},"agent":{"type":"object","description":"Optional: who is calling, for our records.","properties":{"name":{"type":"string","description":"Agent or software name"},"url":{"type":"string","description":"Agent homepage or card URL"},"on_behalf_of":{"type":"string","description":"Organisation or person the agent acts for"}}}},"required":["organization","email","country"],"additionalProperties":false},"submit_supplier_offer_input":{"type":"object","properties":{"company":{"type":"string","maxLength":200},"country":{"type":"string","maxLength":80},"email":{"type":"string","format":"email"},"website":{"type":"string","maxLength":300},"contact_name":{"type":"string","maxLength":120},"phone":{"type":"string","maxLength":60},"supplier_type":{"type":"string","enum":["manufacturer","kit_assembler","brand_or_importer","component_maker","trading_company","other"]},"products":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"name":{"type":"string","maxLength":300},"category":{"type":"string","maxLength":100},"unit_price":{"type":"string","description":"e.g. \"USD 4.20 FOB Ningbo at 100k units\"","maxLength":200},"moq":{"type":"integer","minimum":1},"capacity_per_week":{"type":"integer","minimum":1},"lead_time_days":{"type":"integer","minimum":0,"maximum":3650},"certifications":{"type":"array","items":{"type":"string","maxLength":100},"maxItems":30}},"required":["name"]}},"description":{"type":"string","maxLength":4000},"catalog_url":{"type":"string","maxLength":500},"notes":{"type":"string","maxLength":4000},"agent":{"type":"object","description":"Optional: who is calling, for our records.","properties":{"name":{"type":"string","description":"Agent or software name"},"url":{"type":"string","description":"Agent homepage or card URL"},"on_behalf_of":{"type":"string","description":"Organisation or person the agent acts for"}}}},"required":["company","country","email"],"additionalProperties":false},"get_request_status_input":{"type":"object","properties":{"request_id":{"type":"string","description":"e.g. RCQ-20261017-ABCD2345"},"email":{"type":"string","format":"email"}},"required":["request_id","email"],"additionalProperties":false}}}}