{"openapi":"3.1.0","info":{"title":"ITA Trade Data (BYOK) API","version":"0.1.0","description":"ITA Trade Data (BYOK) lets an AI assistant read your own ITA Trade Data data through the ITA Trade Data API with a key you supply (ITA Data Services subscription key). Read-only: 8 tools (search_screening_list, list_screening_sources, search_fta_tariff_rates, count_fta_tariff_rates, search_trade_events, search_trade_leads, search_business_service_providers, search_ita_offices). The BYOK key...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-itatrade.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-itatrade/docs"},"termsOfService":"https://connectorbay.com/byok-itatrade/terms"},"servers":[{"url":"https://byok-itatrade.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-itatrade/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/search_screening_list":{"post":{"operationId":"search_screening_list","summary":"Search the Consolidated Screening List of restricted parties (Commerce, State and Treasury export control and sanctions ","description":"Search the Consolidated Screening List of restricted parties (Commerce, State and Treasury export control and sanctions lists) by name, country, type, source list or address. Use for \"Is 'Acme Trading' on any US export screening list\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Name to search; matches the name and alternate names.","title":"Name"},"fuzzy_name":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":false,"description":"True to tolerate spelling differences in name (works only together with name).","title":"Fuzzy Name"},"sources":{"anyOf":[{"enum":["CAP","CMIC","DPL","DTC","EL","FSE","ISN","MBS","MEU","PLC","SDN","SSI","UVL"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this list by source abbreviation: DPL, EL, MEU, UVL (Commerce); ISN, DTC (State); SDN, SSI, FSE, PLC, CAP, MBS, CMIC (Treasury).","title":"Sources"},"types":{"anyOf":[{"enum":["Aircraft","Entity","Individual","Vessel"],"type":"string"},{"type":"null"}],"default":null,"description":"Only this entry type.","title":"Types"},"countries":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"ISO alpha-2 country code(s), comma-separated, matched against addresses, nationalities and citizenships.","title":"Countries"},"city":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"City to match in addresses.","title":"City"},"state":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"State to match in addresses.","title":"State"},"full_address":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Free text matched against address, city, state and postal code.","title":"Full Address"},"size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Results per page (1 to 50).","title":"Size"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip (0 to 1000).","title":"Offset"}},"title":"search_screening_listArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/list_screening_sources":{"post":{"operationId":"list_screening_sources","summary":"List the source lists inside the Consolidated Screening List with their abbreviations and publishing agencies. Use for \"","description":"List the source lists inside the Consolidated Screening List with their abbreviations and publishing agencies. Use for \"Which lists make up the US Consolidated Screening List\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_screening_sourcesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_fta_tariff_rates":{"post":{"operationId":"search_fta_tariff_rates","summary":"Search tariff rates under US free trade agreements by reporter country, partner country and HS code prefix: base rate, a","description":"Search tariff rates under US free trade agreements by reporter country, partner country and HS code prefix: base rate, annual staging, quota notes and rule text. Use for \"What are the FTA tariff rates for HS 0901 under agreements with the United States\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"reporter_names":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Reporter country name(s), comma-separated (see count_fta_tariff_rates for valid names).","title":"Reporter Names"},"partner_names":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Partner country name(s), comma-separated.","title":"Partner Names"},"hs_code_prefix":{"anyOf":[{"maxLength":12,"type":"string"},{"type":"null"}],"default":null,"description":"HS code prefix, for example '0901'.","title":"Hs Code Prefix"},"size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Results per page (1 to 50).","title":"Size"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip (0 to 1000).","title":"Offset"}},"title":"search_fta_tariff_ratesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/count_fta_tariff_rates":{"post":{"operationId":"count_fta_tariff_rates","summary":"Count FTA tariff rate records and list the reporter and partner country names that can be used as filters. Use for \"Whic","description":"Count FTA tariff rate records and list the reporter and partner country names that can be used as filters. Use for \"Which countries have FTA tariff rate data with the United States\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"count_fta_tariff_ratesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_trade_events":{"post":{"operationId":"search_trade_events","summary":"Search upcoming trade shows, missions and export events by keyword, country, state, industry, event type and start date ","description":"Search upcoming trade shows, missions and export events by keyword, country, state, industry, event type and start date range. Use for \"What trade events for the food industry start after 1 March 2027\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text matched against event name and description.","title":"Q"},"countries":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Country name(s), comma-separated.","title":"Countries"},"states":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"US state abbreviation(s), comma-separated.","title":"States"},"event_types":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Event type(s), comma-separated.","title":"Event Types"},"industries":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Industry name(s), comma-separated.","title":"Industries"},"start_date_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Start date on or after this date (YYYY-MM-DD).","title":"Start Date From"},"start_date_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Start date on or before this date (YYYY-MM-DD).","title":"Start Date To"},"size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Results per page (1 to 50).","title":"Size"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip (0 to 1000).","title":"Offset"}},"title":"search_trade_eventsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_trade_leads":{"post":{"operationId":"search_trade_leads","summary":"Search overseas government tender and contract opportunities for US exporters by keyword, country and tender or contract","description":"Search overseas government tender and contract opportunities for US exporters by keyword, country and tender or contract date range. Use for \"Are there tenders in Kenya mentioning medical equipment\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text matched against lead title and description.","title":"Q"},"country_codes":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"ISO country code(s), comma-separated.","title":"Country Codes"},"tender_start_from":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Tender start date on or after (YYYY-MM-DD).","title":"Tender Start From"},"tender_start_to":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":null,"description":"Tender start date on or before (YYYY-MM-DD).","title":"Tender Start To"},"size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Results per page (1 to 50).","title":"Size"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip (0 to 1000).","title":"Offset"}},"title":"search_trade_leadsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_business_service_providers":{"post":{"operationId":"search_business_service_providers","summary":"Search the directory of US and foreign businesses that provide export services, by keyword, category and ITA office. Use","description":"Search the directory of US and foreign businesses that provide export services, by keyword, category and ITA office. Use for \"Which freight forwarders are listed in the ITA business service provider directory\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text matched against company names and descriptions.","title":"Q"},"categories":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Service category name(s), comma-separated.","title":"Categories"},"ita_offices":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"ITA office name(s), comma-separated.","title":"Ita Offices"},"size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Results per page (1 to 50).","title":"Size"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip (0 to 1000).","title":"Offset"}},"title":"search_business_service_providersArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/search_ita_offices":{"post":{"operationId":"search_ita_offices","summary":"Search ITA export assistance offices in the US and abroad by keyword, country, state or assigned ZIP code. Use for \"Whic","description":"Search ITA export assistance offices in the US and abroad by keyword, country, state or assigned ZIP code. Use for \"Which ITA office covers ZIP code 94025\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"q":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Text matched against post, office name, address or assigned ZIP codes.","title":"Q"},"country_codes":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter country code(s), comma-separated.","title":"Country Codes"},"states":{"anyOf":[{"maxLength":60,"type":"string"},{"type":"null"}],"default":null,"description":"Two-letter US state abbreviation(s), comma-separated.","title":"States"},"assigned_zip_codes":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"default":null,"description":"Five-digit ZIP code(s), comma-separated.","title":"Assigned Zip Codes"},"size":{"anyOf":[{"maximum":50,"minimum":1,"type":"integer"},{"type":"null"}],"default":10,"description":"Results per page (1 to 50).","title":"Size"},"offset":{"anyOf":[{"maximum":1000,"minimum":0,"type":"integer"},{"type":"null"}],"default":0,"description":"Number of results to skip (0 to 1000).","title":"Offset"}},"title":"search_ita_officesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}