[{"data":1,"prerenderedAt":1314},["ShallowReactive",2],{"changelog:off-route":3,"\u002Finquiries":4,"docs-nav":1280},null,{"id":5,"title":6,"body":7,"cards":3,"description":1267,"extension":1268,"group":1269,"hero":3,"icon":1270,"meta":1271,"navTitle":1272,"navigation":1273,"order":201,"path":1274,"seo":1275,"sitemap":1276,"stem":1278,"__hash__":1279},"docs\u002Finquiries.md","Creating and updating inquiries",{"type":8,"value":9,"toc":1257},"minimark",[10,14,18,103,113,151,156,218,474,477,679,686,691,760,846,855,878,881,919,938,951,955,965,968,990,993,997,1003,1046,1049,1139,1142,1146,1161,1176,1180,1192,1196,1237,1253],[11,12,6],"h1",{"id":13},"creating-and-updating-inquiries",[15,16,17],"p",{},"An inquiry is a request for a price. Four endpoints let an integration raise one\nand look after it:",[19,20,21,37],"table",{},[22,23,24],"thead",{},[25,26,27,31,34],"tr",{},[28,29,30],"th",{},"Operation",[28,32,33],{},"Endpoint",[28,35,36],{},"Answers",[38,39,40,58,73,87],"tbody",{},[25,41,42,46,52],{},[43,44,45],"td",{},"Create",[43,47,48],{},[49,50,51],"code",{},"POST \u002Fv1\u002Finquiry",[43,53,54,57],{},[49,55,56],{},"201"," with the inquiry",[25,59,60,63,68],{},[43,61,62],{},"Update",[43,64,65],{},[49,66,67],{},"PATCH \u002Fv1\u002Finquiry\u002F{inquiry}",[43,69,70,57],{},[49,71,72],{},"200",[25,74,75,78,83],{},[43,76,77],{},"Cancel",[43,79,80],{},[49,81,82],{},"POST \u002Fv1\u002Finquiry\u002F{inquiry}\u002Fcancel",[43,84,85,57],{},[49,86,72],{},[25,88,89,92,97],{},[43,90,91],{},"Delete",[43,93,94],{},[49,95,96],{},"DELETE \u002Fv1\u002Finquiry\u002F{inquiry}",[43,98,99,102],{},[49,100,101],{},"204",", no body",[15,104,105,108,109,112],{},[49,106,107],{},"{inquiry}"," takes the Cargoplot reference or the numeric id, as the reads do.\nEvery answer that carries an inquiry renders it exactly as\n",[49,110,111],{},"GET \u002Fv1\u002Finquiry\u002F{inquiry}"," does, so one parser handles both.",[15,114,115,116,119,120,119,123,119,126,129,130,119,133,119,136,119,139,142,143,146,147,150],{},"A request body uses the names and types of the inquiry you read. What only\nCargoplot sets is left out: ",[49,117,118],{},"id",", ",[49,121,122],{},"reference",[49,124,125],{},"status",[49,127,128],{},"create_time",",\n",[49,131,132],{},"update_time",[49,134,135],{},"requester_user_id",[49,137,138],{},"organization_id",[49,140,141],{},"total_volume"," and\n",[49,144,145],{},"total_weight",". Sending one of them is refused, as is any other key the request\ndoes not have, so a typo such as ",[49,148,149],{},"carrier"," fails loudly instead of being ignored.",[152,153,155],"h2",{"id":154},"creating-an-inquiry","Creating an inquiry",[157,158,163],"pre",{"className":159,"code":160,"filename":51,"language":161,"meta":162,"style":162},"language-bash shiki shiki-themes github-dark github-dark","curl -X POST 'https:\u002F\u002Fapi.cargoplot.com\u002Fv1\u002Finquiry' \\\n  -H 'X-Cargoplot-Key: \u003Ctoken>' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d @inquiry.json\n","bash","",[49,164,165,188,199,209],{"__ignoreMap":162},[166,167,170,174,178,182,185],"span",{"class":168,"line":169},"line",1,[166,171,173],{"class":172},"sFR8T","curl",[166,175,177],{"class":176},"s8ozJ"," -X",[166,179,181],{"class":180},"s4wv1"," POST",[166,183,184],{"class":180}," 'https:\u002F\u002Fapi.cargoplot.com\u002Fv1\u002Finquiry'",[166,186,187],{"class":176}," \\\n",[166,189,191,194,197],{"class":168,"line":190},2,[166,192,193],{"class":176},"  -H",[166,195,196],{"class":180}," 'X-Cargoplot-Key: \u003Ctoken>'",[166,198,187],{"class":176},[166,200,202,204,207],{"class":168,"line":201},3,[166,203,193],{"class":176},[166,205,206],{"class":180}," 'Content-Type: application\u002Fjson'",[166,208,187],{"class":176},[166,210,212,215],{"class":168,"line":211},4,[166,213,214],{"class":176},"  -d",[166,216,217],{"class":180}," @inquiry.json\n",[157,219,224],{"className":220,"code":221,"filename":222,"language":223,"meta":162,"style":162},"language-json shiki shiki-themes github-dark github-dark","{\n  \"description\": \"20 pallets of coffee\",\n  \"origin\": {\n    \"region_code\": \"NL\",\n    \"locality\": \"Rotterdam\",\n    \"address_lines\": [\"Wilhelminakade 123\"]\n  },\n  \"destination\": { \"region_code\": \"DE\", \"locality\": \"Hamburg\" },\n  \"cargo_ready_date\": \"2026-11-02\",\n  \"cargo_type\": \"CARGO_TYPE_PALLETS\",\n  \"transport_modes\": [\"TRANSPORT_MODE_ROAD\"],\n  \"incoterms\": [\"INCOTERM_FCA\"],\n  \"lcl\": {\n    \"components\": [\n      { \"width\": 120, \"height\": 150, \"depth\": 80, \"weight\": 250, \"quantity\": 4 }\n    ]\n  }\n}\n","inquiry.json","json",[49,225,226,232,245,253,265,278,293,299,329,342,355,369,382,390,399,456,462,468],{"__ignoreMap":162},[166,227,228],{"class":168,"line":169},[166,229,231],{"class":230},"suv1-","{\n",[166,233,234,237,240,243],{"class":168,"line":190},[166,235,236],{"class":176},"  \"description\"",[166,238,239],{"class":230},": ",[166,241,242],{"class":180},"\"20 pallets of coffee\"",[166,244,129],{"class":230},[166,246,247,250],{"class":168,"line":201},[166,248,249],{"class":176},"  \"origin\"",[166,251,252],{"class":230},": {\n",[166,254,255,258,260,263],{"class":168,"line":211},[166,256,257],{"class":176},"    \"region_code\"",[166,259,239],{"class":230},[166,261,262],{"class":180},"\"NL\"",[166,264,129],{"class":230},[166,266,268,271,273,276],{"class":168,"line":267},5,[166,269,270],{"class":176},"    \"locality\"",[166,272,239],{"class":230},[166,274,275],{"class":180},"\"Rotterdam\"",[166,277,129],{"class":230},[166,279,281,284,287,290],{"class":168,"line":280},6,[166,282,283],{"class":176},"    \"address_lines\"",[166,285,286],{"class":230},": [",[166,288,289],{"class":180},"\"Wilhelminakade 123\"",[166,291,292],{"class":230},"]\n",[166,294,296],{"class":168,"line":295},7,[166,297,298],{"class":230},"  },\n",[166,300,302,305,308,311,313,316,318,321,323,326],{"class":168,"line":301},8,[166,303,304],{"class":176},"  \"destination\"",[166,306,307],{"class":230},": { ",[166,309,310],{"class":176},"\"region_code\"",[166,312,239],{"class":230},[166,314,315],{"class":180},"\"DE\"",[166,317,119],{"class":230},[166,319,320],{"class":176},"\"locality\"",[166,322,239],{"class":230},[166,324,325],{"class":180},"\"Hamburg\"",[166,327,328],{"class":230}," },\n",[166,330,332,335,337,340],{"class":168,"line":331},9,[166,333,334],{"class":176},"  \"cargo_ready_date\"",[166,336,239],{"class":230},[166,338,339],{"class":180},"\"2026-11-02\"",[166,341,129],{"class":230},[166,343,345,348,350,353],{"class":168,"line":344},10,[166,346,347],{"class":176},"  \"cargo_type\"",[166,349,239],{"class":230},[166,351,352],{"class":180},"\"CARGO_TYPE_PALLETS\"",[166,354,129],{"class":230},[166,356,358,361,363,366],{"class":168,"line":357},11,[166,359,360],{"class":176},"  \"transport_modes\"",[166,362,286],{"class":230},[166,364,365],{"class":180},"\"TRANSPORT_MODE_ROAD\"",[166,367,368],{"class":230},"],\n",[166,370,372,375,377,380],{"class":168,"line":371},12,[166,373,374],{"class":176},"  \"incoterms\"",[166,376,286],{"class":230},[166,378,379],{"class":180},"\"INCOTERM_FCA\"",[166,381,368],{"class":230},[166,383,385,388],{"class":168,"line":384},13,[166,386,387],{"class":176},"  \"lcl\"",[166,389,252],{"class":230},[166,391,393,396],{"class":168,"line":392},14,[166,394,395],{"class":176},"    \"components\"",[166,397,398],{"class":230},": [\n",[166,400,402,405,408,410,413,415,418,420,423,425,428,430,433,435,438,440,443,445,448,450,453],{"class":168,"line":401},15,[166,403,404],{"class":230},"      { ",[166,406,407],{"class":176},"\"width\"",[166,409,239],{"class":230},[166,411,412],{"class":176},"120",[166,414,119],{"class":230},[166,416,417],{"class":176},"\"height\"",[166,419,239],{"class":230},[166,421,422],{"class":176},"150",[166,424,119],{"class":230},[166,426,427],{"class":176},"\"depth\"",[166,429,239],{"class":230},[166,431,432],{"class":176},"80",[166,434,119],{"class":230},[166,436,437],{"class":176},"\"weight\"",[166,439,239],{"class":230},[166,441,442],{"class":176},"250",[166,444,119],{"class":230},[166,446,447],{"class":176},"\"quantity\"",[166,449,239],{"class":230},[166,451,452],{"class":176},"4",[166,454,455],{"class":230}," }\n",[166,457,459],{"class":168,"line":458},16,[166,460,461],{"class":230},"    ]\n",[166,463,465],{"class":168,"line":464},17,[166,466,467],{"class":230},"  }\n",[166,469,471],{"class":168,"line":470},18,[166,472,473],{"class":230},"}\n",[15,475,476],{},"The answer is the new inquiry, shortened here:",[157,478,480],{"className":220,"code":479,"language":223,"meta":162,"style":162},"{\n  \"id\": \"1652\",\n  \"status\": \"STATUS_RECEIVED\",\n  \"reference\": \"C69M-DFR7\",\n  \"description\": \"20 pallets of coffee\",\n  \"cargo_ready_date\": \"2026-11-02\",\n  \"cargo_type\": \"CARGO_TYPE_PALLETS\",\n  \"hs_code_count\": 1,\n  \"total_volume\": 5.76,\n  \"total_weight\": 1000,\n  \"lcl\": {\n    \"components\": [\n      { \"width\": 120, \"height\": 150, \"depth\": 80, \"weight\": 250, \"quantity\": 4 }\n    ],\n    \"tail_lift\": false,\n    \"pallet_exchange\": false\n  }\n}\n",[49,481,482,486,498,510,522,532,542,552,564,576,588,594,600,644,649,661,671,675],{"__ignoreMap":162},[166,483,484],{"class":168,"line":169},[166,485,231],{"class":230},[166,487,488,491,493,496],{"class":168,"line":190},[166,489,490],{"class":176},"  \"id\"",[166,492,239],{"class":230},[166,494,495],{"class":180},"\"1652\"",[166,497,129],{"class":230},[166,499,500,503,505,508],{"class":168,"line":201},[166,501,502],{"class":176},"  \"status\"",[166,504,239],{"class":230},[166,506,507],{"class":180},"\"STATUS_RECEIVED\"",[166,509,129],{"class":230},[166,511,512,515,517,520],{"class":168,"line":211},[166,513,514],{"class":176},"  \"reference\"",[166,516,239],{"class":230},[166,518,519],{"class":180},"\"C69M-DFR7\"",[166,521,129],{"class":230},[166,523,524,526,528,530],{"class":168,"line":267},[166,525,236],{"class":176},[166,527,239],{"class":230},[166,529,242],{"class":180},[166,531,129],{"class":230},[166,533,534,536,538,540],{"class":168,"line":280},[166,535,334],{"class":176},[166,537,239],{"class":230},[166,539,339],{"class":180},[166,541,129],{"class":230},[166,543,544,546,548,550],{"class":168,"line":295},[166,545,347],{"class":176},[166,547,239],{"class":230},[166,549,352],{"class":180},[166,551,129],{"class":230},[166,553,554,557,559,562],{"class":168,"line":301},[166,555,556],{"class":176},"  \"hs_code_count\"",[166,558,239],{"class":230},[166,560,561],{"class":176},"1",[166,563,129],{"class":230},[166,565,566,569,571,574],{"class":168,"line":331},[166,567,568],{"class":176},"  \"total_volume\"",[166,570,239],{"class":230},[166,572,573],{"class":176},"5.76",[166,575,129],{"class":230},[166,577,578,581,583,586],{"class":168,"line":344},[166,579,580],{"class":176},"  \"total_weight\"",[166,582,239],{"class":230},[166,584,585],{"class":176},"1000",[166,587,129],{"class":230},[166,589,590,592],{"class":168,"line":357},[166,591,387],{"class":176},[166,593,252],{"class":230},[166,595,596,598],{"class":168,"line":371},[166,597,395],{"class":176},[166,599,398],{"class":230},[166,601,602,604,606,608,610,612,614,616,618,620,622,624,626,628,630,632,634,636,638,640,642],{"class":168,"line":384},[166,603,404],{"class":230},[166,605,407],{"class":176},[166,607,239],{"class":230},[166,609,412],{"class":176},[166,611,119],{"class":230},[166,613,417],{"class":176},[166,615,239],{"class":230},[166,617,422],{"class":176},[166,619,119],{"class":230},[166,621,427],{"class":176},[166,623,239],{"class":230},[166,625,432],{"class":176},[166,627,119],{"class":230},[166,629,437],{"class":176},[166,631,239],{"class":230},[166,633,442],{"class":176},[166,635,119],{"class":230},[166,637,447],{"class":176},[166,639,239],{"class":230},[166,641,452],{"class":176},[166,643,455],{"class":230},[166,645,646],{"class":168,"line":392},[166,647,648],{"class":230},"    ],\n",[166,650,651,654,656,659],{"class":168,"line":401},[166,652,653],{"class":176},"    \"tail_lift\"",[166,655,239],{"class":230},[166,657,658],{"class":176},"false",[166,660,129],{"class":230},[166,662,663,666,668],{"class":168,"line":458},[166,664,665],{"class":176},"    \"pallet_exchange\"",[166,667,239],{"class":230},[166,669,670],{"class":176},"false\n",[166,672,673],{"class":168,"line":464},[166,674,467],{"class":230},[166,676,677],{"class":168,"line":470},[166,678,473],{"class":230},[15,680,681,682,685],{},"A new inquiry starts in ",[49,683,684],{},"STATUS_RECEIVED",". Creating it gathers no prices, and the\nanswer carries none.",[687,688,690],"h3",{"id":689},"what-a-create-needs","What a create needs",[692,693,694,701,723,737,743,754],"ul",{},[695,696,697,700],"li",{},[49,698,699],{},"description",".",[695,702,703,706,707,710,711,714,715,718,719,722],{},[49,704,705],{},"origin"," and ",[49,708,709],{},"destination",", each with a ",[49,712,713],{},"region_code"," (ISO 3166-1 alpha-2,\nsuch as ",[49,716,717],{},"NL",") and a ",[49,720,721],{},"locality",", the city.",[695,724,725,728,729,732,733,736],{},[49,726,727],{},"cargo_ready_date",", the date the cargo can be collected, as ",[49,730,731],{},"YYYY-MM-DD",". It\nhas to be a date that exists: ",[49,734,735],{},"2026-02-31"," is refused.",[695,738,739,742],{},[49,740,741],{},"cargo_type",", which also decides the shape of the cargo.",[695,744,745,746,749,750,753],{},"At least one ",[49,747,748],{},"transport_modes"," entry and at least one ",[49,751,752],{},"incoterms"," entry, each\ngiven once. Incoterms are a list because each one is priced on its own.",[695,755,756,757,759],{},"The cargo, in the branch that matches ",[49,758,741],{},":",[19,761,762,776],{},[22,763,764],{},[25,765,766,770,773],{},[28,767,768],{},[49,769,741],{},[28,771,772],{},"Branch",[28,774,775],{},"What it needs",[38,777,778,804],{},[25,779,780,785,790],{},[43,781,782],{},[49,783,784],{},"CARGO_TYPE_CONTAINERS",[43,786,787],{},[49,788,789],{},"fcl",[43,791,792,793,710,796,799,800,803],{},"At least one entry in ",[49,794,795],{},"containers",[49,797,798],{},"type"," and a ",[49,801,802],{},"quantity"," above zero",[25,805,806,814,819],{},[43,807,808,119,811],{},[49,809,810],{},"CARGO_TYPE_PALLETS",[49,812,813],{},"CARGO_TYPE_PACKAGES",[43,815,816],{},[49,817,818],{},"lcl",[43,820,792,821,710,824,119,827,706,830,833,834,838,839,842,843,845],{},[49,822,823],{},"components",[49,825,826],{},"width",[49,828,829],{},"height",[49,831,832],{},"depth"," in ",[835,836,837],"strong",{},"centimetres",", a ",[49,840,841],{},"weight"," in kilograms and a ",[49,844,802],{},", all above zero",[15,847,848,849,851,852,854],{},"Send only the branch that matches. For an inquiry created here, ",[49,850,141],{},"\n(cubic metres) and ",[49,853,145],{}," (kilograms) are computed from the components; a\ncontainer inquiry has neither.",[15,856,857,858,860,861,864,865,868,869,871,872,868,875,877],{},"Everything else is optional, and leaving it out gives what the app's inquiry form\ngives when it is left untouched: ",[49,859,658],{}," for an option, an empty list for a\nfilter, ",[49,862,863],{},"0"," for a limit. ",[49,866,867],{},"max_transit_days"," of ",[49,870,863],{}," means no limit, and\n",[49,873,874],{},"hs_code_count",[49,876,863],{}," means one.",[15,879,880],{},"A few options only mean something for one kind of cargo, and setting one that\ndoes not fit is refused rather than ignored:",[692,882,883,892,898],{},[695,884,885,706,888,891],{},[49,886,887],{},"storage",[49,889,890],{},"timeslot_delivery"," are for pallets and packages.",[695,893,894,897],{},[49,895,896],{},"side_loader_delivery"," is for containers.",[695,899,900,706,903,906,907,909,910,706,913,916,917,700],{},[49,901,902],{},"tail_lift",[49,904,905],{},"pallet_exchange"," sit inside ",[49,908,818],{},";\n",[49,911,912],{},"min_free_demurrage_days",[49,914,915],{},"min_free_detention_days"," inside ",[49,918,789],{},[15,920,921,922,925,926,929,930,933,934,937],{},"The ports are UN\u002FLOCODEs (",[49,923,924],{},"NLRTM","), ",[49,927,928],{},"carriers"," are SCAC codes, and\n",[49,931,932],{},"insured_goods_value"," is an amount in the currency's minor unit:\n",[49,935,936],{},"{ \"currency\": \"EUR\", \"amount_cents\": 150000 }"," is €1,500.00.",[15,939,940,941,946,947,950],{},"The vocabularies — cargo types, transport modes, container types, special\ncontents, Incoterms — are the ones in the ",[942,943,945],"a",{"href":944},"\u002Fglossary","glossary",", sent by name.\nOne exception: ",[49,948,949],{},"TRANSPORT_MODE_BARGE"," cannot be requested on an inquiry yet, and\nis refused.",[152,952,954],{"id":953},"a-retried-create","A retried create",[15,956,957,958,960,961,964],{},"Nothing extra is needed to make a create safe to retry. If an identical request\nfrom your organization arrives within ten minutes of the first, it creates\nnothing: the answer is the same ",[49,959,56],{}," with the inquiry the first request made,\nand the response carries ",[49,962,963],{},"Idempotent-Replayed: true"," so you can tell.",[15,966,967],{},"Identical means the same content, not the same bytes. Key order, whitespace, and\nsending a default explicitly rather than leaving it out do not make two requests\ndifferent.",[692,969,970,976,982],{},[695,971,972,975],{},[835,973,974],{},"After ten minutes",", the same body creates a new inquiry. That is how you\ncopy one.",[695,977,978,981],{},[835,979,980],{},"An inquiry you have since cancelled or deleted"," is never replayed; the same\nbody creates a new one.",[695,983,984,987,988,700],{},[835,985,986],{},"Two identical inquiries within ten minutes on purpose"," are one inquiry\nanswered twice. Change something that tells them apart, such as the\n",[49,989,699],{},[15,991,992],{},"A refused request stores nothing, so once you have fixed it, sending it again is\na fresh create.",[152,994,996],{"id":995},"updating-an-inquiry","Updating an inquiry",[15,998,999,1002],{},[49,1000,1001],{},"PATCH"," changes the fields the body carries and leaves the rest alone. Which\nfields those are is read from the keys you send, so there is nothing else to\nsupply:",[157,1004,1007],{"className":159,"code":1005,"filename":1006,"language":161,"meta":162,"style":162},"curl -X PATCH 'https:\u002F\u002Fapi.cargoplot.com\u002Fv1\u002Finquiry\u002FC69M-DFR7' \\\n  -H 'X-Cargoplot-Key: \u003Ctoken>' \\\n  -H 'Content-Type: application\u002Fjson' \\\n  -d '{ \"cargo_ready_date\": \"2026-11-09\", \"carriers\": [\"MAEU\", \"CMDU\"] }'\n","PATCH \u002Fv1\u002Finquiry\u002FC69M-DFR7",[49,1008,1009,1023,1031,1039],{"__ignoreMap":162},[166,1010,1011,1013,1015,1018,1021],{"class":168,"line":169},[166,1012,173],{"class":172},[166,1014,177],{"class":176},[166,1016,1017],{"class":180}," PATCH",[166,1019,1020],{"class":180}," 'https:\u002F\u002Fapi.cargoplot.com\u002Fv1\u002Finquiry\u002FC69M-DFR7'",[166,1022,187],{"class":176},[166,1024,1025,1027,1029],{"class":168,"line":190},[166,1026,193],{"class":176},[166,1028,196],{"class":180},[166,1030,187],{"class":176},[166,1032,1033,1035,1037],{"class":168,"line":201},[166,1034,193],{"class":176},[166,1036,206],{"class":180},[166,1038,187],{"class":176},[166,1040,1041,1043],{"class":168,"line":211},[166,1042,214],{"class":176},[166,1044,1045],{"class":180}," '{ \"cargo_ready_date\": \"2026-11-09\", \"carriers\": [\"MAEU\", \"CMDU\"] }'\n",[15,1047,1048],{},"The answer is the whole inquiry as it now stands.",[692,1050,1051,1070,1084,1099,1115,1129],{},[695,1052,1053,1059,1060,1062,1063,1066,1067,1069],{},[835,1054,1055,1056,1058],{},"A list, an address and ",[49,1057,932],{}," are each one value",", replaced\nby what you send, so send them complete. An ",[49,1061,705],{}," sent without a\n",[49,1064,1065],{},"postal_code"," leaves the inquiry without one; a ",[49,1068,823],{}," list replaces\nevery component.",[695,1071,1072,1079,1080,1083],{},[835,1073,1074,706,1076,1078],{},[49,1075,789],{},[49,1077,818],{}," only group their fields",", so each key inside them changes on\nits own. ",[49,1081,1082],{},"{ \"fcl\": { \"min_free_demurrage_days\": 7 } }"," changes that number and\nleaves the containers as they are.",[695,1085,1086,239,1089,119,1092,1095,1096,700],{},[835,1087,1088],{},"An empty value clears a field",[49,1090,1091],{},"\"port_of_loading\": \"\"",[49,1093,1094],{},"\"carriers\": []",".\nA field a create requires cannot be cleared, and answers ",[49,1097,1098],{},"400",[695,1100,1101,1104,1105,1107,1108,1110,1111,1114],{},[835,1102,1103],{},"No update can leave an inquiry without cargo."," An empty ",[49,1106,795],{}," or\n",[49,1109,823],{}," list, or a bare ",[49,1112,1113],{},"\"lcl\": {}",", is refused.",[695,1116,1117,1123,1124,706,1126,1128],{},[835,1118,1119,1120,1122],{},"Switching ",[49,1121,741],{}," between containers and pallets or packages"," needs\nthe new kind of cargo in the same request, since an inquiry for containers\ncannot keep pallets as its cargo. The options of the kind it leaves are\ncleared with it: ",[49,1125,902],{},[49,1127,905],{}," on a switch to containers,\nthe free-day counts on a switch away. Pallets to packages keeps the\ncomponents.",[695,1130,1131,1134,1135,1138],{},[835,1132,1133],{},"The rules are judged against the inquiry you would end up with",", not only\nthe body. ",[49,1136,1137],{},"{ \"storage\": true }"," on a container inquiry is refused, although the\nbody says nothing about containers.",[15,1140,1141],{},"Repeating an update is harmless: the second one leaves the inquiry as the first\ndid.",[152,1143,1145],{"id":1144},"cancelling-and-deleting","Cancelling and deleting",[15,1147,1148,1150,1151,1153,1154,1157,1158,1160],{},[49,1149,82],{}," withdraws an inquiry: it answers ",[49,1152,72],{}," with\nthe inquiry in ",[49,1155,1156],{},"STATUS_CANCELLED",", and no quote will follow. A cancelled inquiry\nstays in your list and can still be read. Reopening one is done in the app, not\nover the API. Cancelling an inquiry that is already cancelled changes nothing and\nanswers ",[49,1159,72],{}," again.",[15,1162,1163,1165,1166,1168,1169,1172,1173,1175],{},[49,1164,96],{}," answers ",[49,1167,101],{}," with no body and takes the inquiry\nout of your inquiries: it is no longer listed and no longer readable. It is not\nerased from Cargoplot's records. Deleting it again answers ",[49,1170,1171],{},"404",", since there is\nnothing left for you to see — so a retried delete that gets a ",[49,1174,1171],{}," has\nsucceeded.",[152,1177,1179],{"id":1178},"once-a-quote-is-accepted","Once a quote is accepted",[15,1181,1182,1183,1186,1187,1189,1190,700],{},"An accepted quote fixes the inquiry, because a shipment is being built from it.\nFrom then on, every write answers ",[49,1184,1185],{},"409"," — update, cancel and delete alike — with\none exception: a ",[49,1188,1001],{}," that changes only the ",[49,1191,699],{},[152,1193,1195],{"id":1194},"when-a-write-is-refused","When a write is refused",[19,1197,1198,1208],{},[22,1199,1200],{},[25,1201,1202,1205],{},[28,1203,1204],{},"Status",[28,1206,1207],{},"Why",[38,1209,1210,1219,1228],{},[25,1211,1212,1216],{},[43,1213,1214],{},[49,1215,1098],{},[43,1217,1218],{},"A field breaks a rule, or the body has a key the request does not have",[25,1220,1221,1225],{},[43,1222,1223],{},[49,1224,1171],{},[43,1226,1227],{},"No inquiry with that reference or id in your organization",[25,1229,1230,1234],{},[43,1231,1232],{},[49,1233,1185],{},[43,1235,1236],{},"A quote has been accepted, see above",[15,1238,1239,1240,1243,1244,1247,1248,1252],{},"A rule broken by a field answers with a ",[49,1241,1242],{},"google.rpc.BadRequest"," naming the field\nand why, one entry per problem, and every rule the body breaks is in the same\nanswer. An unknown key is named in ",[49,1245,1246],{},"message"," instead. The ",[942,1249,1251],{"href":1250},"\u002Ferrors","errors"," page\nshows both shapes in full and says which failures are worth retrying.",[1254,1255,1256],"style",{},"html pre.shiki code .sFR8T, html code.shiki .sFR8T{--shiki-default:#B392F0;--shiki-dark:#B392F0}html pre.shiki code .s8ozJ, html code.shiki .s8ozJ{--shiki-default:#79B8FF;--shiki-dark:#79B8FF}html pre.shiki code .s4wv1, html code.shiki .s4wv1{--shiki-default:#9ECBFF;--shiki-dark:#9ECBFF}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .suv1-, html code.shiki .suv1-{--shiki-default:#E1E4E8;--shiki-dark:#E1E4E8}",{"title":162,"searchDepth":190,"depth":190,"links":1258},[1259,1262,1263,1264,1265,1266],{"id":154,"depth":190,"text":155,"children":1260},[1261],{"id":689,"depth":201,"text":690},{"id":953,"depth":190,"text":954},{"id":995,"depth":190,"text":996},{"id":1144,"depth":190,"text":1145},{"id":1178,"depth":190,"text":1179},{"id":1194,"depth":190,"text":1195},"Raise an inquiry, change it, withdraw or delete it, and what a retried create gets back.","md","working","mdi-file-document-edit-outline",{},"Inquiries",true,"\u002Finquiries",{"title":6,"description":1267},{"loc":1274,"lastmod":1277},"2026-09-22","inquiries","KjZ75auFGb5ivcdDedJSUPuKJ2rgQCy22HUVz-9VZ-E",[1281,1286,1290,1291,1295,1299,1303,1306,1309],{"path":1282,"title":1283,"navTitle":1283,"icon":1284,"group":1285,"order":169},"\u002F","Overview","mdi-book-open-page-variant-outline","getting-started",{"path":1287,"title":1288,"navTitle":3,"icon":1289,"group":1285,"order":190},"\u002Fauthentication","Authentication","mdi-key-variant",{"path":1274,"title":6,"navTitle":1272,"icon":1270,"group":1269,"order":201},{"path":1292,"title":1293,"navTitle":3,"icon":1294,"group":1269,"order":211},"\u002Ftracking","Shipment tracking","mdi-map-marker-path",{"path":1296,"title":1297,"navTitle":3,"icon":1298,"group":1269,"order":267},"\u002Frate-limits","Rate limits","mdi-speedometer",{"path":1300,"title":1301,"navTitle":3,"icon":1302,"group":1269,"order":280},"\u002Fpagination","Pagination and filtering","mdi-filter-variant",{"path":1250,"title":1304,"navTitle":3,"icon":1305,"group":1269,"order":295},"Errors","mdi-alert-outline",{"path":944,"title":1307,"navTitle":3,"icon":1308,"group":1269,"order":301},"Glossary","mdi-book-alphabet",{"path":1310,"title":1311,"navTitle":3,"icon":1312,"group":1313,"order":331},"\u002Fversioning","Versioning","mdi-tag-outline","current",1790183270753]