--- title: Delivery Exist slug: fourkites-api-reference/delivery-exist icon: {"apiMethod":"GET"} createdAt: 2025-12-22T06:05:23.000Z --- This API will allow you to check whether a **Delivery** exists in the system by Delivery number. :::hint{type="info"} **Note**: All date fields in this API use **UTC** exclusively. ::: :::hint{type="info"} ### Rate Limit **1 request per second** ::: :::hint{type="info"} ### Format Supported **JSON** ::: :::hint{type="info"} ### Authenticated Resource **API Key** ::: For more information on Authentication, [click here](https://docs.fourkites.com/api-reference/authentication). :::ApiMethodV2 ```json { "name": "Production", "method": "GET", "url": "https://api.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY", "description": "", "tab": "examples", "examples": { "languages": [ { "id": "gF0dOK4HYYsWGKHjTilu2", "language": "curl", "code": "curl --location 'https://api.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY' \\\n--header 'Content-Type: application/json' \\\n--header 'apikey: REPLACE_KEY_VALUE'", "customLabel": "" }, { "id": "7yZTu6HsbyhKQtpjKEWqJ", "language": "java", "code": "OkHttpClient client = new OkHttpClient().newBuilder()\n .build();\nMediaType mediaType = MediaType.parse(\"application/json\");\nRequestBody body = RequestBody.create(mediaType, \"\");\nRequest request = new Request.Builder()\n .url(\"https://api.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY\")\n .method(\"GET\", body)\n .addHeader(\"Content-Type\", \"application/json\")\n .addHeader(\"apikey\", \"REPLACE_KEY_VALUE\")\n .build();\nResponse response = client.newCall(request).execute();", "customLabel": "" }, { "id": "cvfiRajIUXV1mwifHV9-q", "language": "javascript", "code": "var settings = {\n \"url\": \"https://api.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY\",\n \"method\": \"GET\",\n \"timeout\": 0,\n \"headers\": {\n \"Content-Type\": \"application/json\",\n \"apikey\": \"REPLACE_KEY_VALUE\"\n },\n};\n\n$.ajax(settings).done(function (response) {\n console.log(response);\n});", "customLabel": "" }, { "id": "97y8wYDkfqcJtP5fgJQ9j", "language": "swift", "code": "var request = URLRequest(url: URL(string: \"https://api.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY\")!,timeoutInterval: Double.infinity)\nrequest.addValue(\"application/json\", forHTTPHeaderField: \"Content-Type\")\nrequest.addValue(\"REPLACE_KEY_VALUE\", forHTTPHeaderField: \"apikey\")\n\nrequest.httpMethod = \"GET\"\n\nlet task = URLSession.shared.dataTask(with: request) { data, response, error in \n guard let data = data else {\n print(String(describing: error))\n return\n }\n print(String(data: data, encoding: .utf8)!)\n}\n\ntask.resume()\n", "customLabel": "" }, { "id": "j9OukH2nMe4qrFrV6ryXx", "language": "csharp", "code": "var client = new HttpClient();\nvar request = new HttpRequestMessage(HttpMethod.Get, \"https://api.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY\");\nrequest.Headers.Add(\"apikey\", \"REPLACE_KEY_VALUE\");\nvar content = new StringContent(string.Empty);\ncontent.Headers.ContentType = new MediaTypeHeaderValue(\"application/json\");\nrequest.Content = content;\nvar response = await client.SendAsync(request);\nresponse.EnsureSuccessStatusCode();\nConsole.WriteLine(await response.Content.ReadAsStringAsync());\n", "customLabel": "" }, { "id": "dg9TSJXG9pqyjn2A3xGDs", "language": "go", "code": "package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"io/ioutil\"\n)\n\nfunc main() {\n\n url := \"https://api.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY\"\n method := \"GET\"\n\n client := &http.Client {\n }\n req, err := http.NewRequest(method, url, nil)\n\n if err != nil {\n fmt.Println(err)\n return\n }\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"apikey\", \"REPLACE_KEY_VALUE\")\n\n res, err := client.Do(req)\n if err != nil {\n fmt.Println(err)\n return\n }\n defer res.Body.Close()\n\n body, err := ioutil.ReadAll(res.Body)\n if err != nil {\n fmt.Println(err)\n return\n }\n fmt.Println(string(body))\n}", "customLabel": "" }, { "id": "6U7Vo63nfTXra4AFwDYqt", "language": "ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Get.new(url)\nrequest[\"Content-Type\"] = \"application/json\"\nrequest[\"apikey\"] = \"REPLACE_KEY_VALUE\"\n\nresponse = https.request(request)\nputs response.read_body\n", "customLabel": "" }, { "id": "vM4VitkBL2Q-_GSUnRUvS", "language": "python", "code": "import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api.fourkites.com\")\npayload = ''\nheaders = {\n 'Content-Type': 'application/json',\n 'apikey': 'REPLACE_KEY_VALUE'\n}\nconn.request(\"GET\", \"/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY\", payload, headers)\nres = conn.getresponse()\ndata = res.read()\nprint(data.decode(\"utf-8\"))", "customLabel": "" } ], "selectedLanguageId": "gF0dOK4HYYsWGKHjTilu2" }, "results": { "languages": [ { "id": "ZfM73yGgKCIusMuan-6M6", "language": "200", "code": "{\n \"exists\": true,\n \"deliveryId\": \"4fa898f3-954e-4370-b841-cfc4e3aff07c\",\n \"deliveryIdentifier\": \"SI7956DA-DELIVERY\"\n}", "customLabel": "" }, { "id": "yJNIT8t9JaK5bj0Cw-izS", "language": "404", "code": "{\n \"exists\": false,\n \"deliveryIdentifier\": \"tutuyu\"\n}", "customLabel": "" } ], "selectedLanguageId": "ZfM73yGgKCIusMuan-6M6" }, "request": { "pathParameters": [], "queryParameters": [ { "name": "delivery_identifier", "kind": "required", "type": "string", "description": "The unique business identifier for the delivery to check. This is the customer-facing delivery or shipment identifier (e.g., \"SI7956DA-DELIVERY\")", "": "required" } ], "headerParameters": [ { "name": "apikey", "kind": "required", "type": "string", "description": "Your FourKites API authentication key. Replace REPLACE_KEY_VALUE with your actual API key to authenticate the request.", "": "required" } ], "bodyDataParameters": [], "formDataParameters": [] }, "currentNewParameter": { "label": "Header Parameter", "value": "headerParameters" }, "hasTryItOut": false, "response": [ { "name": "exists", "kind": "optional", "type": "boolean", "description": "Indicates whether the delivery record exists in the system. Returns true if the delivery is found, false if not found." }, { "name": "deliveryId", "kind": "optional", "type": "string", "description": "The unique system-generated identifier (UUID) for the delivery. This internal ID is used for database references and API operations.", "children": [] }, { "name": "deliveryIdentifier", "kind": "optional", "type": "string", "description": "The human-readable delivery identifier used for customer-facing references and tracking. This is typically the business identifier assigned to the delivery (e.g., shipment number, delivery order number).", "children": [] } ], "autoGeneratedAnchorSlug": "production", "legacyHash": "EN015Rxf1mMi02NeLlNwN" } ``` ::: :::ApiMethodV2 ```json { "name": "Staging", "method": "GET", "url": "https://api-staging.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY", "description": "", "tab": "examples", "examples": { "languages": [ { "id": "gF0dOK4HYYsWGKHjTilu2", "language": "curl", "code": "curl --location 'https://api-staging.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY' \\\n--header 'Content-Type: application/json' \\\n--header 'apikey: REPLACE_KEY_VALUE'", "customLabel": "" }, { "id": "v_m4ImFFpXJQBZ9qEKF1I", "language": "java", "code": "OkHttpClient client = new OkHttpClient().newBuilder()\n .build();\nMediaType mediaType = MediaType.parse(\"application/json\");\nRequestBody body = RequestBody.create(mediaType, \"\");\nRequest request = new Request.Builder()\n .url(\"https://api-staging.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY\")\n .method(\"GET\", body)\n .addHeader(\"Content-Type\", \"application/json\")\n .addHeader(\"apikey\", \"REPLACE_KEY_VALUE\")\n .build();\nResponse response = client.newCall(request).execute();", "customLabel": "" }, { "id": "NpFh1WON0torp98L7dIOx", "language": "javascript", "code": "var settings = {\n \"url\": \"https://api-staging.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY\",\n \"method\": \"GET\",\n \"timeout\": 0,\n \"headers\": {\n \"Content-Type\": \"application/json\",\n \"apikey\": \"REPLACE_KEY_VALUE\"\n },\n};\n\n$.ajax(settings).done(function (response) {\n console.log(response);\n});", "customLabel": "" }, { "id": "ptmEMbTwUWQBomf6-N33A", "language": "swift", "code": "var request = URLRequest(url: URL(string: \"https://api-staging.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY\")!,timeoutInterval: Double.infinity)\nrequest.addValue(\"application/json\", forHTTPHeaderField: \"Content-Type\")\nrequest.addValue(\"REPLACE_KEY_VALUE\", forHTTPHeaderField: \"apikey\")\n\nrequest.httpMethod = \"GET\"\n\nlet task = URLSession.shared.dataTask(with: request) { data, response, error in \n guard let data = data else {\n print(String(describing: error))\n return\n }\n print(String(data: data, encoding: .utf8)!)\n}\n\ntask.resume()\n", "customLabel": "" }, { "id": "MVHfhWgrYV9NuAMdxDdJr", "language": "go", "code": "package main\n\nimport (\n \"fmt\"\n \"net/http\"\n \"io/ioutil\"\n)\n\nfunc main() {\n\n url := \"https://api-staging.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY\"\n method := \"GET\"\n\n client := &http.Client {\n }\n req, err := http.NewRequest(method, url, nil)\n\n if err != nil {\n fmt.Println(err)\n return\n }\n req.Header.Add(\"Content-Type\", \"application/json\")\n req.Header.Add(\"apikey\", \"REPLACE_KEY_VALUE\")\n\n res, err := client.Do(req)\n if err != nil {\n fmt.Println(err)\n return\n }\n defer res.Body.Close()\n\n body, err := ioutil.ReadAll(res.Body)\n if err != nil {\n fmt.Println(err)\n return\n }\n fmt.Println(string(body))\n}", "customLabel": "" }, { "id": "owbeOvjqaMzuGXbBzG2nZ", "language": "ruby", "code": "require \"uri\"\nrequire \"json\"\nrequire \"net/http\"\n\nurl = URI(\"https://api-staging.fourkites.com/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY\")\n\nhttps = Net::HTTP.new(url.host, url.port)\nhttps.use_ssl = true\n\nrequest = Net::HTTP::Get.new(url)\nrequest[\"Content-Type\"] = \"application/json\"\nrequest[\"apikey\"] = \"REPLACE_KEY_VALUE\"\n\nresponse = https.request(request)\nputs response.read_body\n", "customLabel": "" }, { "id": "taFIKs6WsPbtM6HPcBT_d", "language": "python", "code": "import http.client\nimport json\n\nconn = http.client.HTTPSConnection(\"api-staging.fourkites.com\")\npayload = ''\nheaders = {\n 'Content-Type': 'application/json',\n 'apikey': 'REPLACE_KEY_VALUE'\n}\nconn.request(\"GET\", \"/deliveries/exists?delivery_identifier=SI7956DA-DELIVERY\", payload, headers)\nres = conn.getresponse()\ndata = res.read()\nprint(data.decode(\"utf-8\"))", "customLabel": "" } ], "selectedLanguageId": "taFIKs6WsPbtM6HPcBT_d" }, "results": { "languages": [ { "id": "ZfM73yGgKCIusMuan-6M6", "language": "200", "code": "{\n \"exists\": true,\n \"deliveryId\": \"4fa898f3-954e-4370-b841-cfc4e3aff07c\",\n \"deliveryIdentifier\": \"SI7956DA-DELIVERY\"\n}", "customLabel": "" }, { "id": "yJNIT8t9JaK5bj0Cw-izS", "language": "404", "code": "{\n \"exists\": false,\n \"deliveryIdentifier\": \"tutuyu\"\n}", "customLabel": "" } ], "selectedLanguageId": "ZfM73yGgKCIusMuan-6M6" }, "request": { "pathParameters": [], "queryParameters": [ { "name": "delivery_identifier", "kind": "required", "type": "string", "description": "The unique business identifier for the delivery to check. This is the customer-facing delivery or shipment identifier (e.g., \"SI7956DA-DELIVERY\")", "": "required" } ], "headerParameters": [ { "name": "apikey", "kind": "required", "type": "string", "description": "Your FourKites API authentication key. Replace REPLACE_KEY_VALUE with your actual API key to authenticate the request.", "": "required" } ], "bodyDataParameters": [], "formDataParameters": [] }, "currentNewParameter": { "label": "Header Parameter", "value": "headerParameters" }, "hasTryItOut": false, "response": [ { "name": "exists", "kind": "optional", "type": "boolean", "description": "Indicates whether the delivery record exists in the system. Returns true if the delivery is found, false if not found." }, { "name": "deliveryId", "kind": "optional", "type": "string", "description": "The unique system-generated identifier (UUID) for the delivery. This internal ID is used for database references and API operations.", "children": [] }, { "name": "deliveryIdentifier", "kind": "optional", "type": "string", "description": "The human-readable delivery identifier used for customer-facing references and tracking. This is typically the business identifier assigned to the delivery (e.g., shipment number, delivery order number).", "children": [] } ], "autoGeneratedAnchorSlug": "staging", "legacyHash": "JHON5B_viQkMgCg3cbTHZ" } ``` :::