Retrieve Purchase Order

Returns a specific PurchaseOrder by its unique identifier.

Loading API schema for PurchaseOrder…

GET/api/v1/purchase-order/{id}

curl -X GET "https://api.nx-us.net/api/v1/purchase-order/{id}" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "X-Connection-Id: YOUR_CONNECTION_ID" \
  -H "Accept: application/json"

Response200

{
  "id": "<string>",
  "objectType": "<string>",
  "createdAt": "<date-time>",
  "updatedAt": "<date-time>",
  "revisionNumber": "<string>",
  "transactionDate": "<date>",
  "currency": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "exchangeRate": "<number>",
  "refNumber": "<string>",
  "memo": "<string>",
  "transactionNumber": "<integer>",
  "vendor": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "class": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "inventorySite": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "shipToEntity": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "template": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "vendorAddress": {
    "line1": "<string>",
    "line2": "<string>",
    "line3": "<string>",
    "line4": "<string>",
    "line5": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postalCode": "<string>",
    "country": "<string>",
    "note": "<string>"
  },
  "vendorAddressBlock": {
    "line1": "<string>",
    "line2": "<string>",
    "line3": "<string>",
    "line4": "<string>",
    "line5": "<string>"
  },
  "shipAddress": {
    "line1": "<string>",
    "line2": "<string>",
    "line3": "<string>",
    "line4": "<string>",
    "line5": "<string>",
    "city": "<string>",
    "state": "<string>",
    "postalCode": "<string>",
    "country": "<string>",
    "note": "<string>"
  },
  "shipAddressBlock": {
    "line1": "<string>",
    "line2": "<string>",
    "line3": "<string>",
    "line4": "<string>",
    "line5": "<string>"
  },
  "terms": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "dueDate": "<date>",
  "expectedDate": "<date>",
  "shipmentMethod": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "shipmentOrigin": "<string>",
  "totalAmount": "<number>",
  "isManuallyClosed": "<boolean>",
  "isFullyReceived": "<boolean>",
  "vendorMessage": "<string>",
  "isQueuedForPrint": "<boolean>",
  "isQueuedForEmailed": "<boolean>",
  "isTaxIncluded": "<boolean>",
  "salesTaxCode": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "otherCustomField1": "<string>",
  "otherCustomField2": "<string>",
  "lines": [
    {
      "id": "<string>",
      "item": {
        "id": null,
        "fullname": null
      },
      "manufacturerPartNumber": "<string>",
      "description": "<string>",
      "quantity": "<number>",
      "unitOfMeasure": "<string>",
      "overrideUnitOfMeasureSet": {
        "id": null,
        "fullname": null
      },
      "rate": "<number>",
      "class": {
        "id": null,
        "fullname": null
      },
      "amount": "<number>",
      "inventorySiteLocation": {
        "id": null,
        "fullname": null
      },
      "customer": {
        "id": null,
        "fullname": null
      },
      "serviceDate": "<date>",
      "salesTaxCode": {
        "id": null,
        "fullname": null
      },
      "receivedQuantity": "<number>",
      "unbilledQuantity": "<number>",
      "isBilled": "<boolean>",
      "isManuallyClosed": "<boolean>",
      "otherCustomField1": "<string>",
      "otherCustomField2": "<string>",
      "customFields": []
    }
  ],
  "lineGroups": [
    {
      "id": "<string>",
      "objectType": "<string>",
      "itemGroup": {
        "id": null,
        "fullname": null
      },
      "description": "<string>",
      "quantity": "<number>",
      "unitOfMeasure": "<string>",
      "overrideUnitOfMeasureSet": {
        "id": null,
        "fullname": null
      },
      "isPrintItemsInGroup": "<boolean>",
      "totalAmount": "<number>",
      "lines": [],
      "customFields": []
    }
  ],
  "amount": "<number>",
  "entity": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "account": {
    "id": "<string>",
    "fullname": "<string>"
  },
  "amountInHomeCurrency": "<string>",
  "hasValidLineItems": "<boolean>",
  "externalId": "<string>",
  "linkedTransactions": [
    {
      "objectType": "<string>",
      "transactionId": "<string>",
      "transactionType": "<string>",
      "transactionDate": "<date>",
      "refNumber": "<string>",
      "linkType": "<string>",
      "amount": "<number>"
    }
  ],
  "expenseLines": [
    {
      "id": "<string>",
      "objectType": "<string>",
      "account": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "amount": "<number>",
      "memo": "<string>",
      "class": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "customer": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "salesRepresentative": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "salesTaxCode": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "taxAmount": "<number>",
      "vendor": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "billableStatus": "NotBillable",
      "customFields": [
        {
          "ownerId": null,
          "name": null,
          "type": null,
          "value": null
        }
      ]
    }
  ],
  "itemLines": [
    {
      "id": "<string>",
      "objectType": "<string>",
      "otherCustomField1": "<string>",
      "otherCustomField2": "<string>",
      "item": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "description": "<string>",
      "quantity": "<number>",
      "cost": "<number>",
      "amount": "<number>",
      "customer": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "class": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "overrideItemAccount": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "billableStatus": "NotBillable",
      "itemGroup": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "unitOfMeasure": "<string>",
      "rate": "<number>",
      "salesTaxCode": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "inventorySite": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "inventorySiteLocation": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "serialNumber": "<string>",
      "lotNumber": "<string>",
      "serviceDate": "<date>",
      "customFields": [
        {
          "ownerId": null,
          "name": null,
          "type": null,
          "value": null
        }
      ]
    }
  ],
  "itemGroupLines": [
    {
      "id": "<string>",
      "objectType": "<string>",
      "itemGroup": {
        "id": "<string>",
        "fullname": "<string>"
      },
      "description": "<string>",
      "quantity": "<number>",
      "totalAmount": "<number>",
      "unitOfMeasure": "<string>",
      "isPrintItemsInGroup": "<boolean>",
      "lines": [
        {
          "id": null,
          "objectType": null,
          "otherCustomField1": null,
          "otherCustomField2": null,
          "item": null,
          "description": null,
          "quantity": null,
          "cost": null,
          "amount": null,
          "customer": null,
          "class": null,
          "overrideItemAccount": null,
          "billableStatus": null,
          "itemGroup": null,
          "unitOfMeasure": null,
          "rate": null,
          "salesTaxCode": null,
          "inventorySite": null,
          "inventorySiteLocation": null,
          "serialNumber": null,
          "lotNumber": null,
          "serviceDate": null,
          "customFields": null
        }
      ],
      "customFields": [
        {
          "ownerId": null,
          "name": null,
          "type": null,
          "value": null
        }
      ]
    }
  ],
  "customFields": [
    {
      "ownerId": "<string>",
      "name": "<string>",
      "type": "<string>",
      "value": "<string>"
    }
  ]
}