> This page is for Developer. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.feedonomics.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.feedonomics.com/_mcp/server. # Get fulfillment requests by order GET https://api.feedamp.feedonomics.com/api/v2/orders/{order-id}/fulfillment_requests Get all fulfillment requests associated with a single customer order Reference: https://docs.feedonomics.com/developer/api-reference/rest/feed-amp-order-api-v2/fulfillment-requests/get-order-fulfillment-requests ## Authentication - `token` header (required) — The Authentication token obtained from the get_token route. - `x-api-key` header (required) — The SSO token obtained from the Feedonomics platform SSO token route. ## Request ### Path parameters - `order-id` (string, required) — FeedAMP Order ID ### Headers - `client` (integer, required) — The ID of the client making the request ## Response ### 200 List of fulfillment requests - `fulfillment_requests` (list of FulfillmentRequest, required) ## Errors ### 401 Unauthorized Error Error validating credentials or access to resources. - `error` (string, required) ### 404 Not Found Error Requested order or fulfillment request does not exist - `any` ### 500 Internal Server Error An unexpected server error occurred. Please contact Feedonomics Support if error persists. - `error` (string, required) ### 503 Service Unavailable Error Server is temporarily unable to handle the request - `error` (string, required) ## Types ### FulfillmentRequest A set of specific items to be fulfilled by a merchant. - `id` (string, required) — Unique identifier for a record - `order_id` (integer, required) — ID of the original customer order - `fulfilling_integration_id` (string, required) — FeedAMP client integration identifier that this fulfillment request belongs to - `fulfilling_integration_name` (string, required) — Customer-defined name for this fulfillment source - `fulfilling_integration_plugin` (string, required) — Which e-commerce platform is this - `fulfillment_request_lines` (list of FulfillmentRequestLine, required) — A collection of FulfillmentRequestLine objects describing the specific items and quantities to fulfill. Note that these lines might not match the contents of the original Order order lines depending on transformation of product data. - `created_at` (datetime, required) — The datetime this record was created. RFC-3339 format 2020-12-31T12:34:56-05:00 - `platform_order_number` (string, optional) — Identifier for an e-commerce platform order record that this Fulfillment Request reflects - `fulfillment_type` (string, optional) — Whether this is a shipment, pickup, digital download, etc. - `shipping_address` (StreetAddress, optional) — Customer's Shipping Information ### FulfillmentRequestLine Details of an item to be fulfilled by the merchant - `id` (string, required) — Unique identifier for a record - `feedamp_order_line_number` (string, required) — Unique identifier for a record - `sku` (string, required) - `quantity` (integer, required) - `product_name` (string, optional) - `shipping_method` (string, optional) ### StreetAddress Customer's Shipping Information - `full_name` (string, required) — Primary name on the shipping address - `address1` (string, required) — Shipping street address, line 1 - `city` (string, required) — Shipping address (City) - `state` (string, required) — Shipping address (State or Province) - `postal_code` (string, required) — Shipping address (Postal or Zip code) - `country_code` (enum, required) — ISO 3166-1 alpha-3 country codes - Allowed values: `ABW`, `AFG`, `AGO`, `AIA`, `ALA`, `ALB`, `AND`, `ARE`, `ARG`, `ARM`, `ASM`, `ATA`, `ATF`, `ATG`, `AUS`, `AUT`, `AZE`, `BDI`, `BEL`, `BEN`, `BES`, `BFA`, `BGD`, `BGR`, `BHR`, `BHS`, `BIH`, `BLM`, `BLR`, `BLZ`, `BMU`, `BOL`, `BRA`, `BRB`, `BRN`, `BTN`, `BVT`, `BWA`, `CAF`, `CAN`, `CCK`, `CHE`, `CHL`, `CHN`, `CIV`, `CMR`, `COD`, `COG`, `COK`, `COL`, `COM`, `CPV`, `CRI`, `CUB`, `CUW`, `CXR`, `CYM`, `CYP`, `CZE`, `DEU`, `DJI`, `DMA`, `DNK`, `DOM`, `DZA`, `ECU`, `EGY`, `ERI`, `ESH`, `ESP`, `EST`, `ETH`, `FIN`, `FJI`, `FLK`, `FRA`, `FRO`, `FSM`, `GAB`, `GBR`, `GEO`, `GGY`, `GHA`, `GIB`, `GIN`, `GLP`, `GMB`, `GNB`, `GNQ`, `GRC`, `GRD`, `GRL`, `GTM`, `GUF`, `GUM`, `GUY`, `HKG`, `HMD`, `HND`, `HRV`, `HTI`, `HUN`, `IDN`, `IMN`, `IND`, `IOT`, `IRL`, `IRN`, `IRQ`, `ISL`, `ISR`, `ITA`, `JAM`, `JEY`, `JOR`, `JPN`, `KAZ`, `KEN`, `KGZ`, `KHM`, `KIR`, `KNA`, `KOR`, `KWT`, `LAO`, `LBN`, `LBR`, `LBY`, `LCA`, `LIE`, `LKA`, `LSO`, `LTU`, `LUX`, `LVA`, `MAC`, `MAF`, `MAR`, `MCO`, `MDA`, `MDG`, `MDV`, `MEX`, `MHL`, `MKD`, `MLI`, `MLT`, `MMR`, `MNE`, `MNG`, `MNP`, `MOZ`, `MRT`, `MSR`, `MTQ`, `MUS`, `MWI`, `MYS`, `MYT`, `NAM`, `NCL`, `NER`, `NFK`, `NGA`, `NIC`, `NIU`, `NLD`, `NOR`, `NPL`, `NRU`, `NZL`, `OMN`, `PAK`, `PAN`, `PCN`, `PER`, `PHL`, `PLW`, `PNG`, `POL`, `PRI`, `PRK`, `PRT`, `PRY`, `PSE`, `PYF`, `QAT`, `REU`, `ROU`, `RUS`, `RWA`, `SAU`, `SDN`, `SEN`, `SGP`, `SGS`, `SHN`, `SJM`, `SLB`, `SLE`, `SLV`, `SMR`, `SOM`, `SPM`, `SRB`, `SSD`, `STP`, `SUR`, `SVK`, `SVN`, `SWE`, `SWZ`, `SXM`, `SYC`, `SYR`, `TCA`, `TCD`, `TGO`, `THA`, `TJK`, `TKL`, `TKM`, `TLS`, `TON`, `TTO`, `TUN`, `TUR`, `TUV`, `TWN`, `TZA`, `UGA`, `UKR`, `UMI`, `URY`, `USA`, `UZB`, `VAT`, `VCT`, `VEN`, `VGB`, `VIR`, `VNM`, `VUT`, `WLF`, `WSM`, `YEM`, `ZAF`, `ZMB`, `ZWE` - `address_type` (string, optional) — The category of the shipping address - `address2` (string, optional) — Shipping street address, line 2 - `address3` (string, optional) — Shipping street address, line 3 (international shipping address info) - `country_code_iso2` (enum, optional) — ISO 3166-1 alpha-2 country codes - Allowed values: `AD`, `AE`, `AF`, `AG`, `AI`, `AL`, `AM`, `AO`, `AQ`, `AR`, `AS`, `AT`, `AU`, `AW`, `AX`, `AZ`, `BA`, `BB`, `BD`, `BE`, `BF`, `BG`, `BH`, `BI`, `BJ`, `BL`, `BM`, `BN`, `BO`, `BQ`, `BR`, `BS`, `BT`, `BV`, `BW`, `BY`, `BZ`, `CA`, `CC`, `CD`, `CF`, `CG`, `CH`, `CI`, `CK`, `CL`, `CM`, `CN`, `CO`, `CR`, `CU`, `CV`, `CW`, `CX`, `CY`, `CZ`, `DE`, `DJ`, `DK`, `DM`, `DO`, `DZ`, `EC`, `EE`, `EG`, `EH`, `ER`, `ES`, `ET`, `FI`, `FJ`, `FK`, `FM`, `FO`, `FR`, `GA`, `GB`, `GD`, `GE`, `GF`, `GG`, `GH`, `GI`, `GL`, `GM`, `GN`, `GP`, `GQ`, `GR`, `GS`, `GT`, `GU`, `GW`, `GY`, `HK`, `HM`, `HN`, `HR`, `HT`, `HU`, `ID`, `IE`, `IL`, `IM`, `IN`, `IO`, `IQ`, `IR`, `IS`, `IT`, `JE`, `JM`, `JO`, `JP`, `KE`, `KG`, `KH`, `KI`, `KM`, `KN`, `KP`, `KR`, `KW`, `KY`, `KZ`, `LA`, `LB`, `LC`, `LI`, `LK`, `LR`, `LS`, `LT`, `LU`, `LV`, `LY`, `MA`, `MC`, `MD`, `ME`, `MF`, `MG`, `MH`, `MK`, `ML`, `MM`, `MN`, `MO`, `MP`, `MQ`, `MR`, `MS`, `MT`, `MU`, `MV`, `MW`, `MX`, `MY`, `MZ`, `NA`, `NC`, `NE`, `NF`, `NG`, `NI`, `NL`, `NO`, `NP`, `NR`, `NU`, `NZ`, `OM`, `PA`, `PE`, `PF`, `PG`, `PH`, `PK`, `PL`, `PM`, `PN`, `PR`, `PS`, `PT`, `PW`, `PY`, `QA`, `RE`, `RO`, `RS`, `RU`, `RW`, `SA`, `SB`, `SC`, `SD`, `SE`, `SG`, `SH`, `SI`, `SJ`, `SK`, `SL`, `SM`, `SN`, `SO`, `SR`, `SS`, `ST`, `SV`, `SX`, `SY`, `SZ`, `TC`, `TD`, `TF`, `TG`, `TH`, `TJ`, `TK`, `TL`, `TM`, `TN`, `TO`, `TR`, `TT`, `TV`, `TW`, `TZ`, `UA`, `UG`, `UM`, `US`, `UY`, `UZ`, `VA`, `VC`, `VE`, `VG`, `VI`, `VN`, `VU`, `WF`, `WS`, `XK`, `YE`, `YT`, `ZA`, `ZM`, `ZW` - `phone` (string, optional) — Shipping phone number ## Examples **Response** ```json { "fulfillment_requests": [ { "id": "109872189273617283", "order_id": 1, "fulfilling_integration_id": "109872189273617283", "fulfilling_integration_name": "BigCommerce UK", "fulfilling_integration_plugin": "BigCommercePlugin", "fulfillment_request_lines": [ { "id": "109872189273617283", "feedamp_order_line_number": "109872189273617283", "sku": "string", "quantity": 1, "product_name": "string", "shipping_method": "string" } ], "created_at": {}, "platform_order_number": "111-99998888-55555", "fulfillment_type": "string", "shipping_address": { "full_name": "John M. Doe", "address1": "123 Fake Street", "city": "Ghost Town", "state": "DC", "postal_code": "91234", "country_code": "USA", "address_type": "business", "address2": "Building 456", "address3": "Room 789", "country_code_iso2": "US", "phone": "9997776666" } } ] } ``` **SDK Code** ```python import requests url = "https://api.feedamp.feedonomics.com/api/v2/orders/109872189273617283/fulfillment_requests" headers = { "client": "1", "token": "" } response = requests.get(url, headers=headers) print(response.json()) ``` ```javascript const url = 'https://api.feedamp.feedonomics.com/api/v2/orders/109872189273617283/fulfillment_requests'; const options = {method: 'GET', headers: {client: '1', token: ''}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go package main import ( "fmt" "net/http" "io" ) func main() { url := "https://api.feedamp.feedonomics.com/api/v2/orders/109872189273617283/fulfillment_requests" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("client", "1") req.Header.Add("token", "") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby require 'uri' require 'net/http' url = URI("https://api.feedamp.feedonomics.com/api/v2/orders/109872189273617283/fulfillment_requests") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["client"] = '1' request["token"] = '' response = http.request(request) puts response.read_body ``` ```java import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://api.feedamp.feedonomics.com/api/v2/orders/109872189273617283/fulfillment_requests") .header("client", "1") .header("token", "") .asString(); ``` ```php request('GET', 'https://api.feedamp.feedonomics.com/api/v2/orders/109872189273617283/fulfillment_requests', [ 'headers' => [ 'client' => '1', 'token' => '', ], ]); echo $response->getBody(); ``` ```csharp using RestSharp; var client = new RestClient("https://api.feedamp.feedonomics.com/api/v2/orders/109872189273617283/fulfillment_requests"); var request = new RestRequest(Method.GET); request.AddHeader("client", "1"); request.AddHeader("token", ""); IRestResponse response = client.Execute(request); ``` ```swift import Foundation let headers = [ "client": "1", "token": "" ] let request = NSMutableURLRequest(url: NSURL(string: "https://api.feedamp.feedonomics.com/api/v2/orders/109872189273617283/fulfillment_requests")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```