Skip to main content

Acumatica API Endpoints

Updated today

Portal/Instance Identifier: acumatica.ipaas.com or AcumaticaERP

Version: 22.200.001

BaseURL

  • Staging/Production: https://{Instance Identifier}/entity/Default/{Version}

NOTES: The {Instance Identifier} shown above is just a placeholder - replace it with your actual Acumatica API URL. Since you might have multiple test environments, this identifier will be different for each one.

The {Version} shown above is also a placeholder for your actual Acumatica API version in the URL. Depending on your test environment setup, this version number might be different.

Table of Contents

Customer Endpoints

Get a Customer with Addresses by CustomerID: (GET)

[BaseURL]/Customer/{CustomerID}?$expand=ShippingContact/Address,BillingContact/Address,PrimaryContact/Address,MainContact,MainContact/Address

Get all Customers for Polling: (GET)

[BaseURL]/Customer?$filter=LastModifiedDateTime gt datetimeoffset'{lastModifiedDT}'

Create a Customer with Addresses: (PUT)

[BaseURL]/Customer?$expand=ShippingContact,BillingContact,PrimaryContact,MainContact,MainContact/Address

Update a Customer with Addresses: (PUT)

[BaseURL]/Customer?$expand=ShippingContact,BillingContact,PrimaryContact,MainContact,MainContact/Address&filter=CustomerID eq '{CustomerID}'

Warehouse Endpoints

Get a Warehouse by WarehouseID: (GET)

[BaseURL]/Warehouse/{WarehouseID}

StockItem Endpoints

Get a StockItem with Warehouse Details by StockItemID: (GET)

[BaseURL]/Customer/StockItem/{StockItemID}?$expand=WarehouseDetails

Get all StockItems for Polling: (GET)

[BaseURL]/StockItem?$filter=LastModifiedDateTime gt datetimeoffset'{lastModifiedDT}'

Sales Order Endpoints

Get a Sales Order with Addresses, Tax Details & Payments by SalesOrderID: (GET)

[BaseURL]/SalesOrder/{SalesOrderID}?$expand=Details,TaxDetails,BillToAddress,ShipToAddress,BillToContact,ShipToContact,Payments

Create/Update Sales Order with Addresses, Line Item, Tax Details & Payments: (PUT)

[BaseURL]/SalesOrder?$expand=Details,TaxDetails,BillToAddress,ShipToAddress,BillToContact,ShipToContact

Invoice Endpoints

Get an Invoice by InvoiceID: (GET)

[BaseURL]/Invoice/{InvoiceID}

Create/Update an Invoice: (PUT)

[BaseURL]/Invoice

Shipment Endpoints

Get Shipment with Packages by ShipmentNo: (GET)

[BaseURL]/Shipment?$filter=ShipmentNbr eq '{shipmentNo_}'&$expand=Orders,Packages

Get all Shipments for Polling: (GET)

[BaseURL]/Shipment?$expand=Orders,Packages&$top={limit}&$skip={page * limit}&$filter=LastModifiedDateTime ge datetimeoffset'{utcMinus4TimeString}'

Create/Update Shipment with Packages: (PUT)

[BaseURL]/Shipment?$expand=Packages

OAuth Endpoints

To Get Access Token & Refresh Token with Cookies: (POST)

https://{Instance Identifier}/identity/connect/token

To Get New Access Token with Cookies using Refresh Token: (POST)

https://{Instance Identifier}/identity/connect/token

Utility/Generic Endpoints

Get Sales Order with Shipments by OrderNO: (GET)

[BaseURL]/SalesOrder?$filter=OrderNbr eq '{OrderNO}'&$expand=shipments

Get Customer by matching Email in Billing Contact of Customer: (GET)

[BaseURL]/Customer?$expand=BillingContact&$filter=BillingContact/Email eq '{emailAddress}'

Get Customer by matching Email in Shipping Contact of Customer: (GET)

[BaseURL]/Customer?$expand=ShippingContact&$filter=ShippingContact/Email eq '{emailAddress}'

Get Customer by matching Email in Primary Contact of Customer: (GET)

[BaseURL]/Customer?$expand=PrimaryContact&$filter=PrimaryContact/Email eq '{emailAddress}'

Get Customer by matching Email in Main Contact of Customer: (GET)

[BaseURL]/Customer?$expand=MainContact&$filter=MainContact/Email eq '{emailAddress}'

Get StockItem by matching SKU: (GET)

[BaseURL]/StockItem/{SKU}?$expand=WarehouseDetails

Get all Taxes: (GET)

[BaseURL]/Tax

Get all TaxZones: (GET)

[BaseURL]/TaxZone
Did this answer your question?