FlxpointAPI Help CenterBeta

[Deprecated] Get Purchase Orders

gethttps://api.flxpoint.com/purchase-ordersDeprecated

Use this when you want to pull purchase order data through the API.

🔑 X-API-TOKEN⏱ 2 req/sToken: Account · Source · Channel

This page explains the endpoint. To send a live test request, use the interactive tester in Stoplight or your own Postman / HTTP client.

Deprecated, please use GET /fulfillment-requests (This endpoint will retrieve back Purchase Orders / Fulfillment Requests)

Request

Query parameters
  • findOrderIdqueryinteger

    Filter Purchase Orders by Order ID.

  • sinceIdqueryinteger

    If passed, returns results with an ID greater than this.

  • poNumbersqueryarray[string]

    Finds elements matching these Purchase Order Numbers. Max 50

  • filterSourceIdqueryinteger

    Filter Purchase Orders by Source ID.

  • filterFulfilmentStatusquerystring

    Filter Purchase Orders by Fulfillment Status. Accepts a comma-separated list to filter on multiple statuses at once.

    allowedAwaiting ShipmentShippedPartially ShippedCanceled
  • filterInvoicedqueryboolean

    Filter Purchase Orders that have source invoice available.

  • filterPageNumberqueryinteger

    Current Page

  • filterPageSizequeryinteger

    Number of entries per page

  • filterStatusquerystring

    Filter Purchase Orders by Purchase Order Status. Accepts a comma-separated list to filter on multiple statuses at once.

    allowedUnprocessedProcessedAcknowledgedCanceledFailedVoidedProcessingAdditional Info RequiredPO/FR # Exceeds Max LengthDuplicate PO/FR #Cross Docked
  • filterIsAcknowledgedqueryboolean

    Filters Purchase Orders based on whether or they were acknowledged (true returns only acknowledged, false only those that are not acknowledged).

  • filterAcknowledgedAfterquerystring (date-time)

    Filter Purchase Orders that were acknowledged after this date-time.

  • filterIsSentqueryboolean

    Filters Purchase Orders based on whether or they have been sent to the source (true returns only those that have been sent, false only those that have not yet been sent).

  • filterSentAfterquerystring (date-time)

    Filter Purchase Orders that were sent after this date-time.

  • filterGeneratedAfterquerystring (date-time)

    Filter Purchase Orders that were generated after this date-time.

  • filterIsCanceledqueryboolean

    Filters Purchase Orders based on whether or they were canceled (true returns only canceled, false only those that are not canceled).

  • filterCanceledAfterquerystring (date-time)

    Filters Purchase Orders that were canceled after this date-time.

  • filterIsVoidedqueryboolean

    Filters Purchase Orders based on whether or they were voided (true returns only voided, false only those that are not voided).

  • filterVoidedAfterquerystring (date-time)

    Filters Purchase Orders that were voided after this date-time.

  • filterIsHeldqueryboolean

    Filters Purchase Orders based on whether or they are being held (true returns only held, false only those that are not held).

  • filterHasErrorqueryboolean

    Filters Purchase Orders based on whether or they have a processing error (true returns only those with errors, false only those without errors).

  • filterEligibleForProcessingqueryboolean

    Filters Fulfillment Requests based on whether the order it related to is Open/Not Managed (true returns only if the order it is related to is Open/Not Managed, false does not filter PO based on order status).

  • filterPurchaseOrderTypeIdsqueryarray[integer]

    Filter Purchase Orders by type id, using ids from the PurchaseOrderType Enum.

  • isPurchaseOrderAccountingSyncedqueryboolean

    Filter to only include Purchase Orders that have been synced to an Accounting Integration.

  • isOrderAccountingSyncedqueryboolean

    Filter to only include those created for Orders that have been synced to an Accounting Integration. Does not relate to the whether or not the Purchase Order has been synced.

  • hasAccountingErrorqueryboolean

    Filter to include Purchase Orders based on whether or not they have a previous error saved while sending to an Accounting Integration

  • filterOrderInvoicedqueryboolean

    Filter to only include those created for Orders that have invoices. Does not relate to the whether or not the Purchase Order has been invoiced.

  • includeTagsqueryboolean

    Determines if "tags" are returned in the response

  • hasTagquerystring

    Only returns Purchase Orders that have the matching tag

  • filterStockCommittedqueryboolean

    Filter Purchase Orders that have stock committed.

  • filterOrderStatusquerystring

    Only returns Purchase Orders associated with orders that have the matching status.

    allowedOpenClosedOn HoldFailedNo Shipping MethodCanceledNot Managed

Example request

get/purchase-orders
curl -X GET "https://api.flxpoint.com/purchase-orders" \
  -H "Accept: application/json" \
  -H "X-API-TOKEN: YOUR_TOKEN"

Responses

200OKapplication/json
array[PurchaseOrder]
idinteger
purchaseOrderNumberstring
orderIdinteger
sentAtstring (date-time)
sourceIdinteger
acknowledgedAtstring (date-time)
secondaryAcknowledgedAtstring (date-time)
canceledAtstring (date-time)
shippingAddressobject
idinteger
namestring
Field created real-time by concatenating "firstName" and "lastName"
addressLine1string
addressLine2string
citystring
statestring
countrystring
stateCodestring
countryCodestring
postalstring
Postal / Zip Code of address
emailstring
phonestring
Free form string field, format isn't enforced
companyNamestring
firstNamestring
lastNamestring
redactedboolean
Represents if the address information was related to an Order with a PII (Personably Identifiable Information) retention policy attached. If the Order exceeds the PII retention period, this address will have information redacted.
hashstring
Represents a unique hash of this address.
billingAddressobject
idinteger
namestring
Field created real-time by concatenating "firstName" and "lastName"
addressLine1string
addressLine2string
citystring
statestring
countrystring
stateCodestring
countryCodestring
postalstring
Postal / Zip Code of address
emailstring
phonestring
Free form string field, format isn't enforced
companyNamestring
firstNamestring
lastNamestring
redactedboolean
Represents if the address information was related to an Order with a PII (Personably Identifiable Information) retention policy attached. If the Order exceeds the PII retention period, this address will have information redacted.
hashstring
Represents a unique hash of this address.
shippingTextstringdeprecated
notestring
A note that can optionally be passed through all the way to the source
confirmationNumberstring
shippedStatusCompletionStatus
allowedNot StartedPartially CompletedCompleted
purchaseOrderStatusobject
namestring
`PO/FR # Exceeds Max Length` and `Duplicate PO/FR #` are now deprecated, and will be referred to as `Fulfillment Request # Exceeds Max Length` and `Duplicate Fulfillment Request #` respectively going forward.
allowedUnprocessedProcessedAcknowledgedCanceledVoidedProcessingAdditional Info RequiredTransferredPO/FR # Exceeds Max LengthDuplicate PO/FR #Processing ErrorFulfillment Request # Exceeds Max LengthDuplicate Fulfillment Request #Cross Docked
handlestring
allowedunprocessedprocessedacknowledgedcanceledvoidedprocessingadditional_info_requiredtransferredpo_number_exceeds_max_lengthduplicateprocessing_errorcross_docked
purchaseOrderFulfillmentStatusobject
namestring
allowedAwaiting ShipmentShippedPartially ShippedCanceled
handlestring
allowedawaiting_shipmentshippedpartially_shippedcanceled
generatedAtstring (date-time)
voidedAtstring (date-time)
accountIdinteger
totalItemsinteger
totalCostnumber
totalQuantityinteger
shippedQuantityinteger
estimatedShippingCostnumber
estimatedDropshipFeenumber
sourceShippingMethodobject
<b>NOTE</b>: The `shippingCarrier` and `shippingCarrierMethod` fields are now deprecated. To get the associated shipping carrier(s) and/or shipping carrier method(s), use the array versions named `shippingCarriers` and `shippingCarrierMethods` instead.
idinteger
sourceIdinteger
descriptionstring
carrierstring
methodstring
shippingCodestringdeprecated
Deprecated. Use `defaultMethodCode` instead.
shippingPolicyobject
idinteger
namestringrequired
deletedAtstring (date-time)
deletedAtstring (date-time)
shippingCarrierobject
idinteger
namestring
handlestring
shipEngineSupportedboolean
shippingCarrierMethodobject
idinteger
shippingCarrierobject
idinteger
namestring
handlestring
shipEngineSupportedboolean
namestring
handlestring
shippingLabelCodestring
It is used to specify the preferred Delivery Service during the purchase of a shipping label when a Fulfillment Request is not rate shopped
defaultCarrierCodestring
The code (text) that your source recognizes for this shipping carrier.
defaultMethodCodestring
Formally known as "Shipping Code". The code (text) that your source recognizes for this shipping method.
overrideDefaultCodesboolean
Use codes provided by ShipEngine to send to your source based on the carrier and method with the best shipping rate.
default false
filterCarriersAndMethodsboolean
Filter to include only some carriers and methods you've connected to ShipEngine.
default false
shippingCarriersarray[ShippingCarrier]
When filtering shipping carriers and methods (i.e. filterCarriersAndMethods = true), this is the list of eligible shipping carriers that may be used for shipping. <b>Note:</b> When filterCarriersAndMethods = false, this list will be empty, but <b>all</b> carriers will be considered for rate shopping.
idinteger
namestring
handlestring
shipEngineSupportedboolean
shippingCarrierMethodsarray[ShippingCarrierMethod]
When filtering shipping carriers and methods (i.e. filterCarriersAndMethods = true), this is the list of eligible methods that may be used for shipping. <b>Note:</b> When filterCarriersAndMethods = false, this list will be empty, but <b>all</b> methods for all carriers will be considered for rate shopping.
idinteger
shippingCarrierobject
idinteger
namestring
handlestring
shipEngineSupportedboolean
namestring
handlestring
useBestFitPackageboolean
Use Flxpoint's predefined package sizes to fit all PO/FR line items in a single package. The largest box possible will be used for oversized PO/FRs. When false, package sizes must be configured for eligibility during rate shopping. You may select any number of common packages and/or use your own custom packages.
default true
commonPackagesarray[CommonPackage]
This will contain the <b>standard</b> package selections enabled for use with this shipping method when configured to use specific packages for shipping, rather than Flxpoint's predefined "Best Fit" package sizes (i.e. useBestFitPackage = false). <b>Note:</b> When useBestFitPackage = true, this list will be empty, and Flxpoint's predefined list of packages will be considered instead.
idinteger
A unique, numerical identifier for the package.
lengthnumber
The length dimension of the package.
widthnumber
The width dimension of the package.
heightnumber
The height dimension of the package.
dimensionUnitobject
handlestring
allowedinchcentimeter
abbreviatedHandlestring
allowedincm
weightnumber
The weight of the package itself (excluding any contents).
weightUnitobject
handlestring
allowedpoundouncegramkilogram
abbreviatedHandlestring
allowedlbozgkg
customPackagesarray[CustomPackage]
This will contain the <b>unique</b> package selections enabled for use with this shipping method when configured to use specific packages for shipping, rather than Flxpoint's predefined "Best Fit" package sizes (i.e. useBestFitPackage = false). <b>Note:</b> When useBestFitPackage = true, this list will be empty, and Flxpoint's predefined list of packages will be considered instead.
idinteger
A unique, numerical identifier for the package.
namestring
Your name for the package.
lengthnumber
The length dimension of the package.
widthnumber
The width dimension of the package.
heightnumber
The height dimension of the package.
dimensionUnitobject
handlestring
allowedinchcentimeter
abbreviatedHandlestring
allowedincm
weightnumber
The weight of the package itself (excluding any contents).
weightUnitobject
handlestring
allowedpoundouncegramkilogram
abbreviatedHandlestring
allowedlbozgkg
createdAtstring (date-time)
The time that the package was created by an account user.
createdByUserEmailstring
The email address of the user who created the package.
updatedAtstring (date-time)
The last time the package details were modified (will be null if never changed).
suppressTrackingboolean
beingProcessedboolean
totalSourceInvoicesinteger
fflInfoRequiredboolean
lastModifiedAtstring (date-time)
accountingSyncedboolean
externalAccountingIdstring
holdUntilstring (date-time)
rateShoppedIdstring
packageDimensionUnitobject
handlestring
allowedinchcentimeter
abbreviatedHandlestring
allowedincm
packageLengthnumber
packageWidthnumber
packageHeightnumber
packageWeightUnitobject
handlestring
allowedpoundouncegramkilogram
abbreviatedHandlestring
allowedlbozgkg
packageWeightnumber
channelIdinteger
crossDockPurchaseOrderIdinteger
Establish this PO as part of a cross docking request by providing the cross dock PO ID
voidedReasonstring
processingErrorReasonstring
The reason this purchase order could not be processed
cancelReasonstring
purchaseOrderItemsarray[PurchaseOrderItem]
idinteger
skustring
quantityinteger
costnumber
itemReferenceIdstring
referenceIdstring
purchaseOrderIdinteger
shippedQuantityinteger
default 0
voidedQuantityinteger
default 0
acknowledgedQuantityinteger
default 0
secondaryAcknowledgedQuantityinteger
default 0
inventoryVariantIdinteger (int64)
orderItemIdinteger
titlestring
externalAccountingItemIdstring
canceledQuantityinteger
weightUnitobject
handlestring
allowedpoundouncegramkilogram
abbreviatedHandlestring
allowedlbozgkg
weightnumber
dimensionUnitobject
handlestring
allowedinchcentimeter
abbreviatedHandlestring
allowedincm
lengthnumber
widthnumber
heightnumber
upcstring
mpnstring
attributesarray[PurchaseOrderItemAttribute]
idinteger
purchaseOrderItemIdinteger
keystring
valuestring
bundleComponentsarray[PurchaseOrderItemBundleComponent]
purchaseOrderItemIdintegerrequired
orderItemBundleComponentIdintegerrequired
lineItemNumberinteger
binLocationstring
subtotalstring
shipmentsarray[Shipment]
idinteger
notestring
trackingUrlstring
trackingNumberstring
carrierstring
methodstring
shippedAtstring (date-time)
insertedAtstring (date-time)
shippingCostnumber
orderIdinteger
purchaseOrderIdinteger
fulfillmentRequestIdinteger
rmaIdinteger
sourceIdinteger
accountIdinteger
partialboolean
suppressedboolean
syncedToChannelboolean
syncErrorstring
crossDockPurchaseOrderIdinteger
shipmentItemsarray[ShipmentItem]
idinteger
skustring
quantityinteger
shipmentIdinteger
inventoryVariantIdinteger (int64)
partialboolean
orderItemIdinteger
purchaseOrderItemIdinteger
this field will soon be deprecated, please start using `fulfillmentRequestItemId` instead. there are basically the same thing, just there has been a terminology change.
fulfillmentRequestItemIdinteger
committedStockReleasedQuantityinteger
rmaItemIdinteger
customFieldsarray[ShipmentCustomField]
customFieldsarray[ShipmentCustomField]
idinteger
namestring
valuestring
updatedAtstring (date-time)
accountingSyncedboolean
invoicesarray[Invoice]
idinteger
invoiceStatusobject
namestring
allowedUnpaidPaidCreditedRefunded
handlestring
allowedunpaidpaidcreditedrefunded
insertedAtstring (date-time)
updatedAtstring (date-time)
purchaseOrderIdinteger
this field is deprecated, please use `fulfillmentRequestId`. The two fields are same.
fulfillmentRequestIdinteger
rmaIdinteger
sourceIdinteger
purchaseOrderNumberstring
this field is deprecated, please start using `fulfillmentRequestNumber`. The two fields are essentially same.
fulfillmentRequestNumberstring
invoiceNumberstring
invoiceDatestring (date-time)
totalCostnumber
totalProductCostnumber
totalShippingCostnumber
totalFeeCostnumber
totalTaxCostnumber
totalOtherCostnumber
totalQuantityinteger
accountingSyncedboolean
accountingSyncErrorstring
externalAccountingIdstring
invoiceItemsarray[InvoiceItem]
idinteger
invoiceIdinteger
invoiceItemTypeobjectrequired
namestring
allowedProductShippingFeeTaxOther
handlestring
allowedproductshippingfeetaxother
sourceVariantIdinteger (int64)
costnumber
skustringrequired
titlestring
quantityinteger
perUnitCostnumber
externalAccountingItemIdstring
customFieldsarray[Source Invoice Custom Field]
totalCreditCostnumber
customFieldsarray[Source Invoice Custom Field]
idinteger
namestring
valuestring
commissionnumberdeprecated
vendorPayoutIdinteger
purchaseOrderAttributesarray[PurchaseOrderAttribute]
idinteger
purchase_order_idinteger
keystring
valuestring
purchaseOrderTypeobject
"Fulfillment Request" name and "FR" abbreviation are now deprecated. Use "Fulfillment Order" name and "FO" abbreviation instead.
idinteger
allowed1234
namestring
allowedPurchase OrderFulfillment RequestTransfer OrderStocking Purchase OrderFulfillment Order
abbreviationstring
allowedPOFRTOSPOFO
handlestring
allowedpurchase_orderfulfillment_requesttransfer_orderstocking_purchase_order
shippingAddressIdinteger
billingAddressIdinteger
sourceShippingMethodIdinteger
shippingDistancenumber
purchaseOrderReceivedStatusobject
handlestring
allowedawaiting_to_receivepartially_receivedreceivedvoided
carrierCodestring
methodCodestring
purchaseOrderPackageobject
A Purchase Order Package contains all metadata needed to buy a shipping label.
idinteger
The ID of the Purchase Order Package.
purchaseOrderIdintegerrequired
The ID of the Purchase Order to buy a shipping label for.
rateIdstring
The Rate Shopping Provider's ID of the rate found that can be used to purchase the shipping label with.
shipFromAddressobject
idinteger
namestring
Field created real-time by concatenating "firstName" and "lastName"
addressLine1string
addressLine2string
citystring
statestring
countrystring
stateCodestring
countryCodestring
postalstring
Postal / Zip Code of address
emailstring
phonestring
Free form string field, format isn't enforced
companyNamestring
firstNamestring
lastNamestring
redactedboolean
Represents if the address information was related to an Order with a PII (Personably Identifiable Information) retention policy attached. If the Order exceeds the PII retention period, this address will have information redacted.
hashstring
Represents a unique hash of this address.
shipToAddressobject
idinteger
namestring
Field created real-time by concatenating "firstName" and "lastName"
addressLine1string
addressLine2string
citystring
statestring
countrystring
stateCodestring
countryCodestring
postalstring
Postal / Zip Code of address
emailstring
phonestring
Free form string field, format isn't enforced
companyNamestring
firstNamestring
lastNamestring
redactedboolean
Represents if the address information was related to an Order with a PII (Personably Identifiable Information) retention policy attached. If the Order exceeds the PII retention period, this address will have information redacted.
hashstring
Represents a unique hash of this address.
createShipmentPostProcessingboolean
This will enable the automatic creation of a shipment with the tracking information from the purchased shipping label. It will be created once the Purchase Order is processed or acknowledged.
updateShipmentOnPurchaseboolean
If true, we will update the order with shipment details immediately after purchasing the label.
shippingDatestring (date-time)
The date that the shipment should be sent.
lengthnumber
Length of the package to ship with this label.
widthnumber
Width of the package to ship with this label.
heightnumber
Height of the package to ship with this label.
dimensionUnitobject
handlestring
allowedinchcentimeter
abbreviatedHandlestring
allowedincm
totalWeightnumber
Total weight of the package with all of its items included to be shipped with this label.
weightUnitobject
handlestring
allowedpoundouncegramkilogram
abbreviatedHandlestring
allowedlbozgkg
shippingCarrierMethodobject
idinteger
shippingCarrierobject
idinteger
namestring
handlestring
shipEngineSupportedboolean
namestring
handlestring
rateShoppingProviderobject
idinteger
namestring
handlestring
supportsLabelGenerationboolean
rateShoppingProviderLabelSizestring
The preferred size of the shipping label.
allowed4x6letter
default "4x6"
commonPackageobject
This is a standard package in Flxpoint that can be associated to a Source Shipping Method for using to ship out orders in.
idinteger
A unique, numerical identifier for the package.
lengthnumber
The length dimension of the package.
widthnumber
The width dimension of the package.
heightnumber
The height dimension of the package.
dimensionUnitobject
handlestring
allowedinchcentimeter
abbreviatedHandlestring
allowedincm
weightnumber
The weight of the package itself (excluding any contents).
weightUnitobject
handlestring
allowedpoundouncegramkilogram
abbreviatedHandlestring
allowedlbozgkg
customPackageobject
This is a specific package created by an account user in Flxpoint that can be associated to a Source Shipping Method for using to ship out orders in.
idinteger
A unique, numerical identifier for the package.
namestring
Your name for the package.
lengthnumber
The length dimension of the package.
widthnumber
The width dimension of the package.
heightnumber
The height dimension of the package.
dimensionUnitobject
handlestring
allowedinchcentimeter
abbreviatedHandlestring
allowedincm
weightnumber
The weight of the package itself (excluding any contents).
weightUnitobject
handlestring
allowedpoundouncegramkilogram
abbreviatedHandlestring
allowedlbozgkg
createdAtstring (date-time)
The time that the package was created by an account user.
createdByUserEmailstring
The email address of the user who created the package.
updatedAtstring (date-time)
The last time the package details were modified (will be null if never changed).
itemsarray[PurchaseOrderPackageItem]
Metadata related to the items to be shipped in the package.
idinteger
purchaseOrderPackageIdinteger
purchaseOrderItemIdinteger
quantityinteger
buyShippingLabelboolean
default false
orderFFLobject
idintegerrequired
orderIdinteger
crossDockPurchaseOrderIdinteger
licenseNumberstringrequired
namestring
addressLine1stringrequired
addressLine2string
citystring
statestring
postalstring
phonestring
imageUrlstring
expiresAtstring (date-time)
companyNamestring
totalWeightnumber
attachmentLinksarray[string]
A list of URLs containing each file attached to this Purchase Order. These include both shipping labels and packing slips.
string
shippingLabelAttachmentLinkstring
URL for downloading the Shipping Label for this PO if one is attached. If more than one shipping label attachment exists, the first will be provided. See `attachmentLinks` for a full list of all attachment URLs for this PO (regardless of type).
packingSlipAttachmentLinkstring
URL for downloading the Packing Slip for this PO if one is attached. If more than one packing slip attachment exists, the first will be provided. See `attachmentLinks` for a full list of all attachment URLs for this PO (regardless of type).
tagsarray[string]
string
fullyReceivedAtstring (date-time)
The date and time when this Purchase Order was fully received.
Example response
[
  {
    "id": 0,
    "purchaseOrderNumber": "string",
    "orderId": 0,
    "sentAt": "2026-04-20T00:00:00Z",
    "sourceId": 0,
    "acknowledgedAt": "2026-04-20T00:00:00Z",
    "secondaryAcknowledgedAt": "2026-04-20T00:00:00Z",
    "canceledAt": "2026-04-20T00:00:00Z",
    "shippingAddress": {
      "id": 0,
      "name": "Joe Smith",
      "addressLine1": "120 1st Lane",
      "addressLine2": "Suite 123",
      "city": "Jacksonville",
      "state": "Florida",
      "country": "United States",
      "stateCode": "FL",
      "countryCode": "US",
      "postal": "12345",
      "email": "person@example.com",
      "phone": "1-555-123-4567",
      "companyName": "string",
      "firstName": "Joe",
      "lastName": "Smith",
      "redacted": true,
      "hash": "string"
    },
    "billingAddress": {
      "id": 0,
      "name": "Joe Smith",
      "addressLine1": "120 1st Lane",
      "addressLine2": "Suite 123",
      "city": "Jacksonville",
      "state": "Florida",
      "country": "United States",
      "stateCode": "FL",
      "countryCode": "US",
      "postal": "12345",
      "email": "person@example.com",
      "phone": "1-555-123-4567",
      "companyName": "string",
      "firstName": "Joe",
      "lastName": "Smith",
      "redacted": true,
      "hash": "string"
    },
    "shippingText": "string",
    "note": "string",
    "confirmationNumber": "string",
    "shippedStatus": "Not Started",
    "purchaseOrderStatus": {
      "name": "Unprocessed",
      "handle": "unprocessed"
    },
    "purchaseOrderFulfillmentStatus": {
      "name": "Awaiting Shipment",
      "handle": "awaiting_shipment"
    },
    "generatedAt": "2026-04-20T00:00:00Z",
    "voidedAt": "2026-04-20T00:00:00Z",
    "accountId": 0,
    "totalItems": 0,
    "totalCost": 0,
    "totalQuantity": 0,
    "shippedQuantity": 0,
    "estimatedShippingCost": 0,
    "estimatedDropshipFee": 0,
    "sourceShippingMethod": {
      "id": 0,
      "sourceId": 0,
      "description": "string",
      "carrier": "string",
      "method": "string",
      "shippingCode": "string",
      "shippingPolicy": {
        "id": 0,
        "name": "string",
        "deletedAt": "2026-04-20T00:00:00Z"
      },
      "deletedAt": "2026-04-20T00:00:00Z",
      "shippingCarrier": {
        "id": 0,
        "name": "string",
        "handle": "string",
        "shipEngineSupported": true
      },
      "shippingCarrierMethod": {
        "id": 0,
        "shippingCarrier": {
          "id": null,
          "name": null,
          "handle": null,
          "shipEngineSupported": null
        },
        "name": "string",
        "handle": "string"
      },
      "shippingLabelCode": "string",
      "defaultCarrierCode": "string",
      "defaultMethodCode": "string",
      "overrideDefaultCodes": true,
      "filterCarriersAndMethods": true,
      "shippingCarriers": [
        {
          "id": null,
          "name": null,
          "handle": null,
          "shipEngineSupported": null
        }
      ],
      "shippingCarrierMethods": [
        {
          "id": null,
          "shippingCarrier": null,
          "name": null,
          "handle": null
        }
      ],
      "useBestFitPackage": true,
      "commonPackages": [
        {
          "id": null,
          "length": null,
          "width": null,
          "height": null,
          "dimensionUnit": null,
          "weight": null,
          "weightUnit": null
        }
      ],
      "customPackages": [
        {
          "id": null,
          "name": null,
          "length": null,
          "width": null,
          "height": null,
          "dimensionUnit": null,
          "weight": null,
          "weightUnit": null,
          "createdAt": null,
          "createdByUserEmail": null,
          "updatedAt": null
        }
      ]
    },
    "suppressTracking": true,
    "beingProcessed": true,
    "totalSourceInvoices": 0,
    "fflInfoRequired": true,
    "lastModifiedAt": "2026-04-20T00:00:00Z",
    "accountingSynced": true,
    "externalAccountingId": "string",
    "holdUntil": "2026-04-20T00:00:00Z",
    "rateShoppedId": "string",
    "packageDimensionUnit": {
      "handle": "inch",
      "abbreviatedHandle": "in"
    },
    "packageLength": 0,
    "packageWidth": 0,
    "packageHeight": 0,
    "packageWeightUnit": {
      "handle": "pound",
      "abbreviatedHandle": "lb"
    },
    "packageWeight": 0,
    "channelId": 0,
    "crossDockPurchaseOrderId": 0,
    "voidedReason": "string",
    "processingErrorReason": "string",
    "cancelReason": "string",
    "purchaseOrderItems": [
      {
        "id": 0,
        "sku": "string",
        "quantity": 0,
        "cost": 0,
        "itemReferenceId": "string",
        "referenceId": "string",
        "purchaseOrderId": 0,
        "shippedQuantity": 0,
        "voidedQuantity": 0,
        "acknowledgedQuantity": 0,
        "secondaryAcknowledgedQuantity": 0,
        "inventoryVariantId": 0,
        "orderItemId": 0,
        "title": "string",
        "externalAccountingItemId": "string",
        "canceledQuantity": 0,
        "weightUnit": {
          "handle": null,
          "abbreviatedHandle": null
        },
        "weight": 0,
        "dimensionUnit": {
          "handle": null,
          "abbreviatedHandle": null
        },
        "length": 0,
        "width": 0,
        "height": 0,
        "upc": "string",
        "mpn": "string",
        "attributes": [
          null
        ],
        "bundleComponents": [
          null
        ],
        "lineItemNumber": 0,
        "binLocation": "string",
        "subtotal": "string"
      }
    ],
    "shipments": [
      {
        "id": 0,
        "note": "string",
        "trackingUrl": "string",
        "trackingNumber": "string",
        "carrier": "string",
        "method": "string",
        "shippedAt": "2026-04-20T00:00:00Z",
        "insertedAt": "2026-04-20T00:00:00Z",
        "shippingCost": 0,
        "orderId": 0,
        "purchaseOrderId": 0,
        "fulfillmentRequestId": 0,
        "rmaId": 0,
        "sourceId": 0,
        "accountId": 0,
        "partial": true,
        "suppressed": true,
        "syncedToChannel": true,
        "syncError": "string",
        "crossDockPurchaseOrderId": 0,
        "shipmentItems": [
          null
        ],
        "customFields": [
          null
        ],
        "updatedAt": "2026-04-20T00:00:00Z",
        "accountingSynced": true
      }
    ],
    "invoices": [
      {
        "id": 0,
        "invoiceStatus": {
          "name": null,
          "handle": null
        },
        "insertedAt": "2026-04-20T00:00:00Z",
        "updatedAt": "2026-04-20T00:00:00Z",
        "purchaseOrderId": 0,
        "fulfillmentRequestId": 0,
        "rmaId": 0,
        "sourceId": 0,
        "purchaseOrderNumber": "string",
        "fulfillmentRequestNumber": "string",
        "invoiceNumber": "string",
        "invoiceDate": "2026-04-20T00:00:00Z",
        "totalCost": 0,
        "totalProductCost": 0,
        "totalShippingCost": 0,
        "totalFeeCost": 0,
        "totalTaxCost": 0,
        "totalOtherCost": 0,
        "totalQuantity": 0,
        "accountingSynced": true,
        "accountingSyncError": "string",
        "externalAccountingId": "string",
        "invoiceItems": [
          null
        ],
        "totalCreditCost": 0,
        "customFields": [
          null
        ],
        "commission": 0,
        "vendorPayoutId": 0
      }
    ],
    "purchaseOrderAttributes": [
      {
        "id": 0,
        "purchase_order_id": 0,
        "key": "string",
        "value": "string"
      }
    ],
    "purchaseOrderType": {
      "id": 1,
      "name": "Purchase Order",
      "abbreviation": "PO",
      "handle": "purchase_order"
    },
    "shippingAddressId": 0,
    "billingAddressId": 0,
    "sourceShippingMethodId": 0,
    "shippingDistance": 0,
    "purchaseOrderReceivedStatus": {
      "handle": "awaiting_to_receive"
    },
    "carrierCode": "string",
    "methodCode": "string",
    "purchaseOrderPackage": {
      "id": 0,
      "purchaseOrderId": 0,
      "rateId": "string",
      "shipFromAddress": {
        "id": 0,
        "name": "Joe Smith",
        "addressLine1": "120 1st Lane",
        "addressLine2": "Suite 123",
        "city": "Jacksonville",
        "state": "Florida",
        "country": "United States",
        "stateCode": "FL",
        "countryCode": "US",
        "postal": "12345",
        "email": "person@example.com",
        "phone": "1-555-123-4567",
        "companyName": "string",
        "firstName": "Joe",
        "lastName": "Smith",
        "redacted": true,
        "hash": "string"
      },
      "shipToAddress": {
        "id": 0,
        "name": "Joe Smith",
        "addressLine1": "120 1st Lane",
        "addressLine2": "Suite 123",
        "city": "Jacksonville",
        "state": "Florida",
        "country": "United States",
        "stateCode": "FL",
        "countryCode": "US",
        "postal": "12345",
        "email": "person@example.com",
        "phone": "1-555-123-4567",
        "companyName": "string",
        "firstName": "Joe",
        "lastName": "Smith",
        "redacted": true,
        "hash": "string"
      },
      "createShipmentPostProcessing": true,
      "updateShipmentOnPurchase": true,
      "shippingDate": "2026-04-20T00:00:00Z",
      "length": 0,
      "width": 0,
      "height": 0,
      "dimensionUnit": {
        "handle": "inch",
        "abbreviatedHandle": "in"
      },
      "totalWeight": 0,
      "weightUnit": {
        "handle": "pound",
        "abbreviatedHandle": "lb"
      },
      "shippingCarrierMethod": {
        "id": 0,
        "shippingCarrier": {
          "id": null,
          "name": null,
          "handle": null,
          "shipEngineSupported": null
        },
        "name": "string",
        "handle": "string"
      },
      "rateShoppingProvider": {
        "id": 0,
        "name": "string",
        "handle": "string",
        "supportsLabelGeneration": true
      },
      "rateShoppingProviderLabelSize": "4x6",
      "commonPackage": {
        "id": 0,
        "length": 0,
        "width": 0,
        "height": 0,
        "dimensionUnit": {
          "handle": null,
          "abbreviatedHandle": null
        },
        "weight": 0,
        "weightUnit": {
          "handle": null,
          "abbreviatedHandle": null
        }
      },
      "customPackage": {
        "id": 0,
        "name": "string",
        "length": 0,
        "width": 0,
        "height": 0,
        "dimensionUnit": {
          "handle": null,
          "abbreviatedHandle": null
        },
        "weight": 0,
        "weightUnit": {
          "handle": null,
          "abbreviatedHandle": null
        },
        "createdAt": "2026-04-20T00:00:00Z",
        "createdByUserEmail": "string",
        "updatedAt": "2026-04-20T00:00:00Z"
      },
      "items": [
        {
          "id": null,
          "purchaseOrderPackageId": null,
          "purchaseOrderItemId": null,
          "quantity": null
        }
      ]
    },
    "buyShippingLabel": true,
    "orderFFL": {
      "id": 0,
      "orderId": 0,
      "crossDockPurchaseOrderId": 0,
      "licenseNumber": "string",
      "name": "string",
      "addressLine1": "string",
      "addressLine2": "string",
      "city": "string",
      "state": "string",
      "postal": "string",
      "phone": "string",
      "imageUrl": "string",
      "expiresAt": "2026-04-20T00:00:00Z",
      "companyName": "string"
    },
    "totalWeight": 0,
    "attachmentLinks": [
      "string"
    ],
    "shippingLabelAttachmentLink": "string",
    "packingSlipAttachmentLink": "string",
    "tags": [
      "string"
    ],
    "fullyReceivedAt": "2026-04-20T00:00:00Z"
  }
]
400Bad Requestapplication/json
errorstring
A generalized error message, may or may not be fit for human consumption.
dataobject
Data points that could be useful in debugging the error.
No properties documented.
Example response
{
  "error": "string",
  "data": {}
}
401Unauthorized

No schema documented for this status.

404Not Found

No schema documented for this status.

OpenAPI fragment
{
  "get": {
    "summary": "[Deprecated] Get Purchase Orders",
    "description": "Deprecated, please use GET /fulfillment-requests\n(This endpoint will retrieve back Purchase Orders / Fulfillment Requests)",
    "parameters": [
      {
        "schema": {
          "type": "integer"
        },
        "in": "query",
        "name": "findOrderId",
        "description": "Filter Purchase Orders by Order ID."
      },
      {
        "schema": {
          "type": "integer"
        },
        "in": "query",
        "name": "sinceId",
        "description": "If passed, returns results with an ID greater than this."
      },
      {
        "schema": {
          "type": "array",
          "maxItems": 50,
          "example": "PO123,PO456,PO789",
          "uniqueItems": true,
          "items": {
            "type": "string"
          }
        },
        "in": "query",
        "name": "poNumbers",
        "description": "Finds elements matching these Purchase Order Numbers. Max 50",
        "style": "form",
        "explode": false
      },
      {
        "schema": {
          "type": "integer"
        },
        "in": "query",
        "name": "filterSourceId",
        "description": "Filter Purchase Orders by Source ID."
      },
      {
        "schema": {
          "type": "string",
          "enum": [
            "Awaiting Shipment",
            "Shipped",
            "Partially Shipped",
            "Canceled"
          ]
        },
        "in": "query",
        "name": "filterFulfilmentStatus",
        "description": "Filter Purchase Orders by Fulfillment Status. Accepts a comma-separated list to filter on multiple statuses at once."
      },
      {
        "schema": {
          "type": "boolean"
        },
        "in": "query",
        "name": "filterInvoiced",
        "description": "Filter Purchase Orders that have source invoice available."
      },
      {
        "schema": {
          "type": "integer",
          "default": 1
        },
        "in": "query",
        "name": "filterPageNumber",
        "description": "Current Page"
      },
      {
        "schema": {
          "type": "integer",
          "default": 20,
          "minimum": 1,
          "maximum": 100
        },
        "in": "query",
        "name": "filterPageSize",
        "description": "Number of entries per page"
      },
      {
        "schema": {
          "type": "string",
          "enum": [
            "Unprocessed",
            "Processed",
            "Acknowledged",
            "Canceled",
            "Failed",
            "Voided",
            "Processing",
            "Additional Info Required",
            "PO/FR # Exceeds Max Length",
            "Duplicate PO/FR #",
            "Cross Docked"
          ]
        },
        "in": "query",
        "name": "filterStatus",
        "description": "Filter Purchase Orders by Purchase Order Status. Accepts a comma-separated list to filter on multiple statuses at once."
      },
      {
        "schema": {
          "type": "boolean"
        },
        "in": "query",
        "name": "filterIsAcknowledged",
        "description": "Filters Purchase Orders based on whether or they were acknowledged (true returns only acknowledged, false only those that are not acknowledged)."
      },
      {
        "schema": {
          "type": "string",
          "format": "date-time"
        },
        "in": "query",
        "name": "filterAcknowledgedAfter",
        "description": "Filter Purchase Orders that were acknowledged after this date-time."
      },
      {
        "schema": {
          "type": "boolean"
        },
        "in": "query",
        "name": "filterIsSent",
        "description": "Filters Purchase Orders based on whether or they have been sent to the source (true returns only those that have been sent, false only those that have not yet been sent)."
      },
      {
        "schema": {
          "type": "string",
          "format": "date-time"
        },
        "in": "query",
        "name": "filterSentAfter",
        "description": "Filter Purchase Orders that were sent after this date-time."
      },
      {
        "schema": {
          "type": "string",
          "format": "date-time"
        },
        "in": "query",
        "name": "filterGeneratedAfter",
        "description": "Filter Purchase Orders that were generated after this date-time."
      },
      {
        "schema": {
          "type": "boolean"
        },
        "in": "query",
        "name": "filterIsCanceled",
        "description": "Filters Purchase Orders based on whether or they were canceled (true returns only canceled, false only those that are not canceled)."
      },
      {
        "schema": {
          "type": "string",
          "format": "date-time"
        },
        "in": "query",
        "name": "filterCanceledAfter",
        "description": "Filters Purchase Orders that were canceled after this date-time."
      },
      {
        "schema": {
          "type": "boolean"
        },
        "in": "query",
        "name": "filterIsVoided",
        "description": "Filters Purchase Orders based on whether or they were voided (true returns only voided, false only those that are not voided)."
      },
      {
        "schema": {
          "type": "string",
          "format": "date-time"
        },
        "in": "query",
        "name": "filterVoidedAfter",
        "description": "Filters Purchase Orders that were voided after this date-time."
      },
      {
        "schema": {
          "type": "boolean"
        },
        "in": "query",
        "name": "filterIsHeld",
        "description": "Filters Purchase Orders based on whether or they are being held (true returns only held, false only those that are not held)."
      },
      {
        "schema": {
          "type": "boolean"
        },
        "in": "query",
        "name": "filterHasError",
        "description": "Filters Purchase Orders based on whether or they have a processing error (true returns only those with errors, false only those without errors)."
      },
      {
        "schema": {
          "type": "boolean"
        },
        "in": "query",
        "name": "filterEligibleForProcessing",
        "description": "Filters Fulfillment Requests based on whether the order it related to is Open/Not Managed (true returns only if the order it is related to is Open/Not Managed, false does not filter PO based on order status)."
      },
      {
        "schema": {
          "type": "array",
          "example": "1234,1235,1257",
          "maxItems": 50,
          "uniqueItems": true,
          "items": {
            "type": "integer"
          }
        },
        "in": "query",
        "name": "filterPurchaseOrderTypeIds",
        "description": "Filter Purchase Orders by type id, using ids from the PurchaseOrderType Enum.",
        "style": "form"
      },
      {
        "schema": {
          "type": "boolean"
        },
        "in": "query",
        "name": "isPurchaseOrderAccountingSynced",
        "description": "Filter to only include Purchase Orders that have been synced to an Accounting Integration."
      },
      {
        "schema": {
          "type": "boolean"
        },
        "in": "query",
        "name": "isOrderAccountingSynced",
        "description": "Filter to only include those created for Orders that have been synced to an Accounting Integration. Does not relate to the whether or not the Purchase Order has been synced."
      },
      {
        "schema": {
          "type": "boolean"
        },
        "in": "query",
        "name": "hasAccountingError",
        "description": "Filter to include Purchase Orders based on whether or not they have a previous error saved while sending to an Accounting Integration"
      },
      {
        "schema": {
          "type": "boolean"
        },
        "in": "query",
        "name": "filterOrderInvoiced",
        "description": "Filter to only include those created for Orders that have invoices. Does not relate to the whether or not the Purchase Order has been invoiced."
      },
      {
        "schema": {
          "type": "boolean",
          "default": "false"
        },
        "in": "query",
        "description": "Determines if \"tags\" are returned in the response",
        "name": "includeTags"
      },
      {
        "schema": {
          "type": "string"
        },
        "in": "query",
        "name": "hasTag",
        "description": "Only returns Purchase Orders that have the matching tag"
      },
      {
        "schema": {
          "type": "boolean"
        },
        "in": "query",
        "name": "filterStockCommitted",
        "description": "Filter Purchase Orders that have stock committed."
      },
      {
        "schema": {
          "type": "string",
          "enum": [
            "Open",
            "Closed",
            "On Hold",
            "Failed",
            "No Shipping Method",
            "Canceled",
            "Not Managed"
          ]
        },
        "in": "query",
        "name": "filterOrderStatus",
        "description": "Only returns Purchase Orders associated with orders that have the matching status."
      }
    ],
    "responses": {
      "200": {
        "description": "OK",
        "content": {
          "application/json": {
            "schema": {
              "type": "array",
              "items": {
                "$ref": "#/components/schemas/PurchaseOrder"
              }
            }
          }
        }
      },
      "400": {
        "description": "Bad Request",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/GenericApiError"
            }
          }
        }
      },
      "401": {
        "description": "Unauthorized"
      },
      "404": {
        "description": "Not Found"
      }
    }
  }
}
Ready to run it? Send the curl from your terminal or Postman, or use the interactive tester in Stoplight.Open in Stoplight