Customers
customer objectA business you sell to, with its contact details, default fulfillment settings, and order policies.
idstringCustomer ID.
objectstringenumValues:customerResource type identifier.
namestringThe customer's business name, as shown throughout the app and on documents.
numberstringHuman-readable customer number used to identify the account, distinct from the id.
statusstringenumValues:normalpreferredhold_shipmentAccount status code, controlling whether the customer can transact.
normal: standard active account with no restrictions.preferred: active account flagged as preferred.hold_shipment: orders can be placed, but shipments are held.hold_all: all activity is on hold.
edi_statusstringenumValues:enableddisabledWhether EDI (Electronic Data Interchange) is enabled for exchanging orders and documents with this customer.
relationship_typestringenumValues:standaloneparentchildThe customer's position in the account hierarchy.
standalone: no parent or child accounts.parent: has one or more child accounts (seechild_accounts).child: belongs to a parent account (seeparent_account).
commission_policystringenumValues:commission_appliedcommission_exemptHow sales commission applies to this customer's orders.
commission_exempt: this customer's orders are exempt from sales commission.commission_applied: sales commission is calculated on this customer's orders.
notestringnullableFree-form note about the customer.
credit_limitquantitynullableMaximum credit extended to this customer.
idstringQuantity ID.
objectstringenumValues:quantityResource type identifier.
valuestring (decimal)Raw decimal value of the quantity, as a string to preserve precision.
This is the unformatted machine value; see display_value for the human-readable rendering with unit and thousands separators.
display_valuestringFormatted value with unit abbreviation (e.g. "$1,234.56" or "100 kg").
Unit of measure for this value (e.g. a currency, mass, or count unit).
idstringUnit ID.
objectstringenumValues:unitResource type identifier.
namestringDisplay name of the unit (e.g. "Gram", "Kilogram").
abbreviationstringShort abbreviation for the unit (e.g. "g", "kg").
typestringenumValues:currencyquantitytimePhysical dimension the unit measures, such as mass, volume, or currency.
A unit can only be converted to another unit of the same dimension. The quantity dimension is for discrete countable items rather than a physical measure.
ratio_numeratorstring (decimal)Conversion ratio numerator relative to the base unit in the same dimension.
ratio_denominatorstring (decimal)Conversion ratio denominator relative to the base unit in the same dimension.
Cannot be zero.
offset_numeratorstring (decimal)Conversion offset numerator, used for temperature-like conversions.
Zero for most unit types.
offset_denominatorstring (decimal)Conversion offset denominator.
Typically 1. Cannot be zero.
is_base_unitbooleanWhether this is the base unit for its dimension.
Conversion ratios are relative to this unit. Base units are platform-defined; account-created units always have this set to false.
ownerownernullableOwner of this resource.
null in this endpoint.created_atstring (date-time)When this unit was created.
updated_atstring (date-time)When this unit was last updated.
contact_infocustomer_contact_infonullableContact information.
objectstringenumValues:customer_contact_infoResource type identifier.
emailstringnullableEmail address.
phonestringnullablePhone number.
urlstringnullableWebsite URL.
freight_preferencescustomer_freight_preferencesnullableFreight and carrier preferences applied to this customer's shipments.
objectstringenumValues:customer_freight_preferencesResource type identifier.
statusstringenumValues:free_freightbilled_freightFreight policy applied to this customer's orders.
free_freight: the customer is not billed for freight.billed_freight: freight is billed to the customer, unless overridden elsewhere.
Default carrier.
idstringCarrier ID.
objectstringenumValues:carrierResource type identifier.
namestringHuman-readable name for the carrier, unique among your account's carriers.
codestringnullableenumValues:fedexupsuspsWell-known carrier identifier, set only for recognized carriers and absent for custom ones.
fedex,ups,usps: integrated carriers managed through Shippo (live rating and labels).will_call: customer picks the order up; no carrier shipment.delivery: delivered by your own vehicles/drivers.ltl,ltl1: less-than-truckload freight carriers.freight_collect: freight billed to and arranged by the receiver.
account_numberstringnullableYour account number with this carrier, used to connect UPS and USPS accounts.
customer_portal_visibilitystringenumValues:visiblehiddenWhether customers can see and select this carrier at checkout in the customer portal.
ownerownernullableProvenance of this carrier.
System-owned carriers are platform-provided defaults shared across all accounts and cannot be deleted; account-owned carriers are custom to your account.
null in this endpoint.Shipping service levels offered by this carrier (e.g. ground, overnight).
objectstringenumValues:listResource type identifier.
page_infoobjectPagination metadata.
next_page_urlstringnullableRelative URL that fetches the next page of results.
null when the last page has been reached.
previous_page_urlstringnullableRelative URL that fetches the previous page of results.
null while on the first page.
has_next_pagebooleanWhether more results exist after this page.
has_prev_pagebooleanWhether results exist before this page.
dataarray of service_levelResources in this page.
idstringService level ID.
objectstringenumValues:service_levelResource type identifier.
namestringHuman-readable name for the service level, shown to customers at checkout when the service level is visible.
service_level_tokenstringCarrier-specific code identifying this service level (e.g. fedex_ground, ups_next_day_air).
Values are carrier-defined, so any non-empty string is accepted.
customer_portal_visibilitystringenumValues:visiblehiddenWhether customers can see and select this service level at checkout in the customer portal.
is_defaultbooleanWhether this is the carrier's default service level, pre-selected when the carrier is chosen.
Each carrier has at most one default; setting a new default clears the previous one.
ownerownernullableProvenance of this service level.
System-owned service levels are platform-provided defaults that cannot be updated or deleted; account-owned service levels are custom to your account.
null in this endpoint.created_atstring (date-time)Creation timestamp.
updated_atstring (date-time)Last updated timestamp.
deleted_atstring (date-time)nullableSoft-delete timestamp.
created_atstring (date-time)Creation timestamp.
updated_atstring (date-time)Last updated timestamp.
Default service level.
idstringService level ID.
objectstringenumValues:service_levelResource type identifier.
namestringHuman-readable name for the service level, shown to customers at checkout when the service level is visible.
service_level_tokenstringCarrier-specific code identifying this service level (e.g. fedex_ground, ups_next_day_air).
Values are carrier-defined, so any non-empty string is accepted.
customer_portal_visibilitystringenumValues:visiblehiddenWhether customers can see and select this service level at checkout in the customer portal.
is_defaultbooleanWhether this is the carrier's default service level, pre-selected when the carrier is chosen.
Each carrier has at most one default; setting a new default clears the previous one.
ownerownernullableProvenance of this service level.
System-owned service levels are platform-provided defaults that cannot be updated or deleted; account-owned service levels are custom to your account.
null in this endpoint.created_atstring (date-time)Creation timestamp.
updated_atstring (date-time)Last updated timestamp.
billing_typestringnullableenumValues:senderthird_partyWho pays the carrier for shipments.
sender: the shipper (you) pays the carrier.third_party: a third party is billed, usingbilling_account.
billing_accountstringnullableCarrier billing account number charged when billing_type is third_party.
defaultscustomer_defaultsnullableDefault settings applied to new orders for this customer.
objectstringenumValues:customer_defaultsResource type identifier.
Default payment term.
idstringPayment term ID.
objectstringenumValues:payment_termResource type identifier.
namestringDisplay name (e.g. Net 30).
statusstringenumValues:activeinactiveLifecycle status of the payment term.
ownerownernullableOwner of this resource, indicating whether it is an Augno-provided system default or was created by your account.
null in this endpoint.created_atstring (date-time)Creation timestamp.
updated_atstring (date-time)Last-updated timestamp.
Default shipping term.
idstringShipping term ID.
objectstringenumValues:shipping_termResource type identifier.
namestringHuman-readable name for the shipping term, used to identify it when assigning shipping terms to customers and orders.
typestringenumValues:free_freightflat_rate_freightcarrier_rate_freightFreight pricing model applied by this shipping term.
free_freight: no shipping cost to the buyer.flat_rate_freight: a fixed shipping cost regardless of order details (seeflat_rate).carrier_rate_freight: shipping cost is determined by the carrier's quoted rate.
ownerownernullableProvenance of this shipping term.
System-owned shipping terms are platform-provided defaults shared across all accounts and cannot be updated or deleted; account-owned shipping terms are custom to your account.
null in this endpoint.flat_ratequantitynullableFixed shipping charge applied to the order.
Applied only when type is flat_rate_freight; ignored for other freight pricing models.
null in this endpoint.minimum_order_valuequantitynullableOrder subtotal a buyer must reach before this term's free-shipping rules apply.
null in this endpoint.Service levels that ship for free under this term (typically once minimum_order_value is met).
null in this endpoint.created_atstring (date-time)When this shipping term was created.
updated_atstring (date-time)When this shipping term was last updated.
Default priority.
idstringPriority ID.
objectstringenumValues:priorityResource type identifier.
codestringenumValues:lownormalhighMachine-readable code identifying the priority level.
low: lowest urgency; worked after normal and high.normal: default urgency for most orders and picks.high: highest urgency; worked ahead of normal and low.
namestringDisplay name of the priority level.
ownerownernullableOwner of this resource.
Priorities are platform-provided and shared across all accounts, so the owner is always the Augno system owner.
null in this endpoint.created_atstring (date-time)Creation timestamp.
updated_atstring (date-time)Last updated timestamp.
Default sales rep.
idstringAccount user ID.
objectstringenumValues:account_userResource type identifier.
statusstringenumValues:activedisabledremovedAccount user status.
active: the user can access the account.disabled: the user is locked out of the account.removed: the user has been removed (soft-deleted) from the account.
Assigned role.
null in this endpoint.departmentdepartmentnullableAssigned department.
null in this endpoint.userusernullableUnderlying user.
idstringUser ID.
objectstringenumValues:userResource type identifier.
emailstringnullableEmail address.
namestringnullableUser's full display name.
usernamestringnullableUsername.
email_verified_atstring (date-time)nullableWhen the user verified their email address.
image_urlstringnullableURL of the user's profile image.
created_atstring (date-time)Creation timestamp.
updated_atstring (date-time)Last updated timestamp.
last_used_atstring (date-time)nullableWhen the user last accessed this account.
created_atstring (date-time)When the account user was created.
updated_atstring (date-time)When the account user was last updated.
notification_preferencescustomer_notification_preferencesnullableNotification preferences.
objectstringenumValues:customer_notification_preferencesResource type identifier.
accepts_invoice_emailsbooleanWhether invoice emails are accepted.
Default billing address.
idstringAddress ID.
objectstringenumValues:addressResource type identifier.
namestringDisplay name of the address.
phonestringnullablePhone number associated with the address.
emailstringnullableEmail address associated with the address.
typestringenumValues:standarddrop_shipHow the address is used.
standard: a normal shipping or billing address.drop_ship: an address an order is shipped to directly, typically a third party or end customer rather than the account itself.
geolocationgeolocationnullableGeolocation details for the address.
null in this endpoint.created_atstring (date-time)Creation timestamp.
updated_atstring (date-time)Last updated timestamp.
Default shipping address.
idstringAddress ID.
objectstringenumValues:addressResource type identifier.
namestringDisplay name of the address.
phonestringnullablePhone number associated with the address.
emailstringnullableEmail address associated with the address.
typestringenumValues:standarddrop_shipHow the address is used.
standard: a normal shipping or billing address.drop_ship: an address an order is shipped to directly, typically a third party or end customer rather than the account itself.
geolocationgeolocationnullableGeolocation details for the address.
null in this endpoint.created_atstring (date-time)Creation timestamp.
updated_atstring (date-time)Last updated timestamp.
The account group of type type_group that categorizes this customer (for example "Distributors").
idstringAccount group ID.
objectstringenumValues:account_groupResource type identifier.
typestringenumValues:pricing_grouptype_groupHow this account group is used.
pricing_group: used for pricing rules, such as a "Preferred" group that receives a special discount.type_group: used to categorize accounts, such as "Consumers" or "Distributors".
namestringDisplay name of the account group.
Unique within the account.
descriptionstringnullableFree-form description of the account group.
commission_policystringenumValues:commission_appliedcommission_exemptHow sales commission applies to accounts in this group.
commission_applied: sales commission is calculated on orders from accounts in this group.commission_exempt: orders from accounts in this group are exempt from commission.
freight_policystringenumValues:free_freightbilled_freightHow freight charges apply to orders from accounts in this group.
free_freight: customers within this group will not have to pay for freight.billed_freight: freight will be applied to any order within this account group, unless overridden elsewhere.
created_atstring (date-time)Creation timestamp.
updated_atstring (date-time)Last updated timestamp.
Account groups of type pricing_group that this customer belongs to, used to apply pricing rules.
objectstringenumValues:listResource type identifier.
page_infoobjectPagination metadata.
next_page_urlstringnullableRelative URL that fetches the next page of results.
null when the last page has been reached.
previous_page_urlstringnullableRelative URL that fetches the previous page of results.
null while on the first page.
has_next_pagebooleanWhether more results exist after this page.
has_prev_pagebooleanWhether results exist before this page.
dataarray of account_groupResources in this page.
idstringAccount group ID.
objectstringenumValues:account_groupResource type identifier.
typestringenumValues:pricing_grouptype_groupHow this account group is used.
pricing_group: used for pricing rules, such as a "Preferred" group that receives a special discount.type_group: used to categorize accounts, such as "Consumers" or "Distributors".
namestringDisplay name of the account group.
Unique within the account.
descriptionstringnullableFree-form description of the account group.
commission_policystringenumValues:commission_appliedcommission_exemptHow sales commission applies to accounts in this group.
commission_applied: sales commission is calculated on orders from accounts in this group.commission_exempt: orders from accounts in this group are exempt from commission.
freight_policystringenumValues:free_freightbilled_freightHow freight charges apply to orders from accounts in this group.
free_freight: customers within this group will not have to pay for freight.billed_freight: freight will be applied to any order within this account group, unless overridden elsewhere.
created_atstring (date-time)Creation timestamp.
updated_atstring (date-time)Last updated timestamp.
Parent account.
Present if this is a child account.
idstringCustomer ID.
objectstringenumValues:customerResource type identifier.
namestringThe customer's business name, as shown throughout the app and on documents.
numberstringHuman-readable customer number used to identify the account, distinct from the id.
statusstringenumValues:normalpreferredhold_shipmentAccount status code, controlling whether the customer can transact.
normal: standard active account with no restrictions.preferred: active account flagged as preferred.hold_shipment: orders can be placed, but shipments are held.hold_all: all activity is on hold.
edi_statusstringenumValues:enableddisabledWhether EDI (Electronic Data Interchange) is enabled for exchanging orders and documents with this customer.
relationship_typestringenumValues:standaloneparentchildThe customer's position in the account hierarchy.
standalone: no parent or child accounts.parent: has one or more child accounts (seechild_accounts).child: belongs to a parent account (seeparent_account).
commission_policystringenumValues:commission_appliedcommission_exemptHow sales commission applies to this customer's orders.
commission_exempt: this customer's orders are exempt from sales commission.commission_applied: sales commission is calculated on this customer's orders.
notestringnullableFree-form note about the customer.
credit_limitquantitynullableMaximum credit extended to this customer.
null in this endpoint.contact_infocustomer_contact_infonullableContact information.
null in this endpoint.freight_preferencescustomer_freight_preferencesnullableFreight and carrier preferences applied to this customer's shipments.
null in this endpoint.defaultscustomer_defaultsnullableDefault settings applied to new orders for this customer.
null in this endpoint.notification_preferencescustomer_notification_preferencesnullableNotification preferences.
null in this endpoint.Default billing address.
null in this endpoint.Default shipping address.
null in this endpoint.The account group of type type_group that categorizes this customer (for example "Distributors").
null in this endpoint.Account groups of type pricing_group that this customer belongs to, used to apply pricing rules.
null in this endpoint.Parent account.
Present if this is a child account.
null in this endpoint.Child accounts.
Present if this is a parent account.
null in this endpoint.created_atstring (date-time)Creation timestamp.
updated_atstring (date-time)Last updated timestamp.
Child accounts.
Present if this is a parent account.
objectstringenumValues:listResource type identifier.
page_infoobjectPagination metadata.
next_page_urlstringnullableRelative URL that fetches the next page of results.
null when the last page has been reached.
previous_page_urlstringnullableRelative URL that fetches the previous page of results.
null while on the first page.
has_next_pagebooleanWhether more results exist after this page.
has_prev_pagebooleanWhether results exist before this page.
dataarray of customerResources in this page.
idstringCustomer ID.
objectstringenumValues:customerResource type identifier.
namestringThe customer's business name, as shown throughout the app and on documents.
numberstringHuman-readable customer number used to identify the account, distinct from the id.
statusstringenumValues:normalpreferredhold_shipmentAccount status code, controlling whether the customer can transact.
normal: standard active account with no restrictions.preferred: active account flagged as preferred.hold_shipment: orders can be placed, but shipments are held.hold_all: all activity is on hold.
edi_statusstringenumValues:enableddisabledWhether EDI (Electronic Data Interchange) is enabled for exchanging orders and documents with this customer.
relationship_typestringenumValues:standaloneparentchildThe customer's position in the account hierarchy.
standalone: no parent or child accounts.parent: has one or more child accounts (seechild_accounts).child: belongs to a parent account (seeparent_account).
commission_policystringenumValues:commission_appliedcommission_exemptHow sales commission applies to this customer's orders.
commission_exempt: this customer's orders are exempt from sales commission.commission_applied: sales commission is calculated on this customer's orders.
notestringnullableFree-form note about the customer.
credit_limitquantitynullableMaximum credit extended to this customer.
null in this endpoint.contact_infocustomer_contact_infonullableContact information.
null in this endpoint.freight_preferencescustomer_freight_preferencesnullableFreight and carrier preferences applied to this customer's shipments.
null in this endpoint.defaultscustomer_defaultsnullableDefault settings applied to new orders for this customer.
null in this endpoint.notification_preferencescustomer_notification_preferencesnullableNotification preferences.
null in this endpoint.Default billing address.
null in this endpoint.Default shipping address.
null in this endpoint.The account group of type type_group that categorizes this customer (for example "Distributors").
null in this endpoint.Account groups of type pricing_group that this customer belongs to, used to apply pricing rules.
null in this endpoint.Parent account.
Present if this is a child account.
null in this endpoint.Child accounts.
Present if this is a parent account.
null in this endpoint.created_atstring (date-time)Creation timestamp.
updated_atstring (date-time)Last updated timestamp.
created_atstring (date-time)Creation timestamp.
updated_atstring (date-time)Last updated timestamp.