GET /purchases/{id}.json

GET /purchases/{id}.json

Path parameters

  • id integer(int64) Required

    Numeric ID of the instance

    Minimum value is 1.

Responses

  • 200 application/json

    Successful response

    Hide response attributes Show response attributes object
    • adjustmentReasonId integer(int32) | null

      Adjustment reason

    • adminNotes string | null

      Admin notes

    • approved boolean Required

      Approved

      Default value is true.

    • billingAddressLineOne string | null

      Billing address line one

    • billingAddressLineTwo string | null

      Billing address line two

    • billingAddressMessage string | null

      Billing address message

    • billingCity string | null

      Billing city

    • billingCountry string | null

      Billing country

    • billingFirstName string | null

      Billing first name

    • billingLastName string | null

      Billing last name

    • billingName string | null

      Billing name

    • billingState string | null

      Billing state

    • billingZip string | null

      Billing zip

    • cancellationStatus string Required

      Cancellation status

      Values are none, partial, or full. Default value is none.

    • cancelled boolean Required

      Cancelled

      Default value is false.

    • cancelledAt string(date-time) | null

      Cancelled at

    • cityTaxLocation string | null

      City tax location

    • cityTaxRate number(float) | null

      City tax rate

    • combinedTaxRate number(float) | null

      Combined tax rate

    • countyTaxLocation string | null

      County tax location

    • countyTaxRate number(float) | null

      County tax rate

    • createdAt string(date-time)

      Created at

    • customerReference string | null

      Customer reference

    • dateOrdered string(date-time) Required

      Date ordered

      Default value is {} (empty).

    • deliveryExpectedAt string(date-time) | null

      Delivery expected at

    • discounts number Required

      Discounts

      Default value is 0.

    • districtTaxRate number(float) | null

      District tax rate

    • dropshipNotes string | null

      Dropship notes

    • dropshipProviderAddressId integer(int32) | null

      Dropship provider address

    • dropshipProviderId integer(int32) | null

      Dropship provider

    • finalized boolean Required

      Finalized

      Default value is true.

    • id integer(int32)

      Id

    • intercomMessageId string | null

      Intercom message

    • internalReference string | null

      Internal reference

    • invalidBillingAddress string | null

      Invalid billing address

    • invalidShippingAddress boolean | null Required

      Invalid shipping address

      Default value is false.

    • inventoryStatus string Required

      Inventory status

      Values are notReceived, partiallyReceived, or received. Default value is notReceived.

    • invoiceStatus string Required

      Invoice status

      Values are notInvoiced, partiallyInvoiced, or invoiced. Default value is notInvoiced.

    • isDropship boolean Required

      Is dropship

    • lastDropshipmentReference integer(int32) | null Required

      Last dropshipment reference

      Default value is 0.

    • lastGoodsReceiptReference integer(int32) | null Required

      Last goods receipt reference

      Default value is 0.

    • lastPurchaseInvoiceReference integer(int32) | null Required

      Last purchase invoice reference

      Default value is 0.

    • locked boolean Required

      Locked

      Default value is false.

    • muteError boolean | null Required

      Mute error

      Default value is false.

    • notes string | null

      Notes

    • orderSplitting string | null Required

      Order splitting

      Values are group, splitTag, splitQuantity, or externalLocationId. Default value is group.

    • orderSplittingKey string | null

      Order splitting key

    • paymentExpectedAt string(date-time) | null

      Payment expected at

    • paymentStatus string Required

      Payment status

      Values are notPaid, partiallyPaid, or paid. Default value is notPaid.

    • priceListId integer(int32) | null

      Price list

    • purchaseId integer(int32) | null

      Purchase

    • purchaseImportExternalId string | null

      Purchase import external

    • purchaseStatusId integer(int32) | null

      Purchase status

    • purchaseType string Required

      Purchase type

      Values are replenishment, dropship, automated_dropship, automated_replenishment, or adjusted_dropship. Default value is replenishment.

    • quantity integer(int32) Required

      Quantity

      Default value is 0.

    • receiverAddressLineOne string | null

      Receiver address line one

    • receiverAddressLineTwo string | null

      Receiver address line two

    • receiverCity string | null

      Receiver city

    • receiverCountry string | null

      Receiver country

    • receiverName string | null

      Receiver name

    • receiverState string | null

      Receiver state

    • receiverZip string | null

      Receiver zip

    • reference string Required

      Reference

    • reminderLastSent string(date-time) | null

      Reminder last sent

    • reminderSent integer(int32) | null Required

      Reminder sent

      Default value is false.

    • returnLabelProblem object | null | array | boolean | integer | number | string

      Return label problem

    • returnStatus string Required

      Return status

      Values are notReturned, partiallyReturned, or returned. Default value is notReturned.

    • saleId integer(int32) | null

      Sale

    • sendSource string | null

      Send source

      Values are manual or automatic.

    • shipmentRouting string | null Required

      Shipment routing

      Values are customer, consolidated, or consolidatedInternational. Default value is customer.

    • shippingAddressLineOne string | null

      Shipping address line one

    • shippingAddressLineTwo string | null

      Shipping address line two

    • shippingAddressMessage boolean | null Required

      Shipping address message

      Default value is false.

    • shippingCity string | null

      Shipping city

    • shippingCountry string | null

      Shipping country

    • shippingExpectedAt string(date-time) | null

      Shipping expected at

    • shippingFirstName string | null

      Shipping first name

    • shippingLastName string | null

      Shipping last name

    • shippingName string | null

      Shipping name

    • shippingRateError string | null

      Shipping rate error

      Values are value or weight.

    • shippingState string | null

      Shipping state

    • shippingZip string | null

      Shipping zip

    • splitTag string | null

      Split tag

    • stateTaxLocation string | null

      State tax location

    • stateTaxRate number(float) | null

      State tax rate

    • subtotal number Required

      Subtotal

      Default value is 0.

    • tags array[string] | null

      Tags

    • tax number Required

      Tax

      Default value is 0.

    • taxCalculation string | null Required

      Tax calculation

      Values are default or custom. Default value is default.

    • taxIncluded boolean Required

      Tax included

      Default value is false.

    • taxShipping boolean | null Required

      Tax shipping

      Default value is true.

    • total number Required

      Total

      Default value is 0.

    • updatedAt string(date-time)

      Updated at

    • userId integer(int32) | null

      User

    • vendorEndpointFormat string | null

      Vendor endpoint format

      Values are json, xml, csv, text, email, website, or phone.

    • vendorEndpointHeaders object | null | array | boolean | integer | number | string

      Vendor endpoint headers

    • vendorEndpointResponse string | null

      Vendor endpoint response

    • vendorId integer(int32) | null

      Vendor

    • vendorReceivedId string | null

      Vendor received

    • vendorReceivedReference string | null

      Vendor received reference

    • vendorReceivedStatus string | null Required

      Vendor received status

      Values are notSent, received, or error. Default value is notSent.

    • vendorReceivedStatusReason string | null Required

      Vendor received status reason

      Values are sent, shipped, or cancelled. Default value is sent.

    • vendorReference string | null

      Vendor reference

    • warehouseId integer(int32) | null

      Warehouse

    • weight number(float) | null Required

      Weight

      Default value is 0.

GET /purchases/{id}.json
curl \
 --request GET 'http://api.example.com/v1/purchases/{id}.json' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200)
{
  "adjustmentReasonId": 42,
  "adminNotes": "string",
  "approved": true,
  "billingAddressLineOne": "string",
  "billingAddressLineTwo": "string",
  "billingAddressMessage": "string",
  "billingCity": "string",
  "billingCountry": "string",
  "billingFirstName": "string",
  "billingFullName": {},
  "billingLastName": "string",
  "billingName": "string",
  "billingState": "string",
  "billingZip": "string",
  "cancellationStatus": "none",
  "cancelled": false,
  "cancelledAt": "2025-05-04T09:42:00Z",
  "cityTaxLocation": "string",
  "cityTaxRate": 42.0,
  "combinedTaxRate": 42.0,
  "countyTaxLocation": "string",
  "countyTaxRate": 42.0,
  "createdAt": "2025-05-04T09:42:00Z",
  "customerReference": "string",
  "dateOrdered": {},
  "deliveryExpectedAt": "2025-05-04T09:42:00Z",
  "discounts": 0,
  "districtTaxRate": 42.0,
  "dropshipNotes": "string",
  "dropshipProviderAddressId": 42,
  "dropshipProviderId": 42,
  "files": {},
  "finalized": true,
  "id": 42,
  "intercomMessageId": "string",
  "internalReference": "string",
  "invalidBillingAddress": "string",
  "invalidShippingAddress": false,
  "inventoryStatus": "notReceived",
  "invoiceProblem": {},
  "invoiceStatus": "notInvoiced",
  "isDropship": true,
  "labelProblem": {},
  "lastDropshipmentReference": 0,
  "lastGoodsReceiptReference": 0,
  "lastPurchaseInvoiceReference": 0,
  "locked": false,
  "muteError": false,
  "notes": "string",
  "orderProblem": {},
  "orderSplitting": "group",
  "orderSplittingKey": "string",
  "pauseProblems": {},
  "paymentExpectedAt": "2025-05-04T09:42:00Z",
  "paymentStatus": "notPaid",
  "priceListId": 42,
  "purchaseId": 42,
  "purchaseImportExternalId": "string",
  "purchaseStatusId": 42,
  "purchaseType": "replenishment",
  "quantity": 0,
  "receiverAddressLineOne": "string",
  "receiverAddressLineTwo": "string",
  "receiverCity": "string",
  "receiverCountry": "string",
  "receiverName": "string",
  "receiverState": "string",
  "receiverZip": "string",
  "reference": "string",
  "reminderLastSent": "2025-05-04T09:42:00Z",
  "reminderSent": false,
  "returnLabelProblem": {},
  "returnStatus": "notReturned",
  "saleId": 42,
  "sendSource": "manual",
  "shipmentRouting": "customer",
  "shippingAddressLineOne": "string",
  "shippingAddressLineTwo": "string",
  "shippingAddressMessage": false,
  "shippingCity": "string",
  "shippingCountry": "string",
  "shippingExpectedAt": "2025-05-04T09:42:00Z",
  "shippingFirstName": "string",
  "shippingFullName": {},
  "shippingLastName": "string",
  "shippingName": "string",
  "shippingRateError": "value",
  "shippingState": "string",
  "shippingZip": "string",
  "splitTag": "string",
  "stateTaxLocation": "string",
  "stateTaxRate": 42.0,
  "subtotal": 0,
  "tags": [
    "string"
  ],
  "tax": 0,
  "taxCalculation": "default",
  "taxIncluded": false,
  "taxShipping": true,
  "total": 0,
  "updatedAt": "2025-05-04T09:42:00Z",
  "userId": 42,
  "vendorEndpointFormat": "json",
  "vendorEndpointHeaders": {},
  "vendorEndpointResponse": "string",
  "vendorId": 42,
  "vendorReceivedId": "string",
  "vendorReceivedReference": "string",
  "vendorReceivedStatus": "notSent",
  "vendorReceivedStatusReason": "sent",
  "vendorReference": "string",
  "warehouseId": 42,
  "weight": 0
}