JUMP TOAPI IntroductionGetting started with the Nitrobox APIAuthentication and authorizationError codes and messagesRetrieve documents from NitroboxQuery data using RSQLOpenAPI Specification (OAS)API Lifecycle ManagementAPI Migration GuideNotifications/WebhooksCustomer and Address NotificationsOrder NotificationsContract NotificationsDocument archivedPayment NotificationsOPOS Decision NotificationsCustomer APICustomersQuery customersgetCreate customerpostRetrieve customergetUpdate customerputQuery customer addressesgetCreate addresspostRetrieve addressgetUpdate addressputConfigurationsCheck validation of all addressespostGet all address validation configsgetCreate or update address validation configpostGet address validation configgetDelete address validation configdeleteDebtors (deprecated)Deprecated: List debtorsgetDeprecated: Create customerpostDeprecated: Retrieve customergetDeprecated: Update customerputDebtors Addresses (deprecated)Deprecated: Query customer addressesgetDeprecated: Create addresspostDeprecated: Retrieve addressgetDeprecated: Update addressputBilling APIBilling GroupsGet a paged result of all billing groupsgetCreate billing grouppostRetrieve billing groupgetUpdate billing groupputDelete billing groupdeleteCreate business segmentpostRetrieve business segmentgetUpdate business segmentputDelete business segmentdeleteSet as defaultpostUpdate splitting configputQuery business segmentsgetOrdersQuery ordersgetCreate orderpostCancel orderspostAdd attachmentpostPrepare document creation for certain itemspostRetrieve attachmentgetSet items on holdpostDelete attachmentdeleteRetrieve ordergetUpdate orderpatchCancel orderpostPrepare document creation for entire orderpostRetry failed billable itemspostQuery agreed order depositsgetAdd multiple order agreed depositspostUpdate an agreed deposit that is assigned to an orderputDelete an agreed deposit that is assigned to an orderdeleteAdd allowancespostCancel allowancespostUpdate allowancesputQuery billable itemsgetRetrieve billable itemgetQuery line itemsgetAdd line itempostCancel line itemspostRetrieve line itemgetEdit line itemputQuery agreed deposits of line itemgetAdd agreed deposit to line itempostUpdate agreed deposit of line itemputDelete agreed deposit of line itemdeletePlans and OptionsGet a page of all plan optionsgetCreate optionpostRetrieve optiongetUpdate optionputDelete optiondeleteQuery plansgetCreate planpostAdd option to a phase of a planpostRetrieve plangetUpdate planputDelete plandeleteContractsStart billing runpostQuery contractsgetCreate contractpostCancel contractspostQuery attachmentsgetTerminate contractspostExtraordinary terminations.postActivate contractpostEnable additional options for a contract. For now only usage options can be added to a contract.postRetry failed billable itemspostTerminate a contractpostExtraordinary terminationpostTermination adaptionpostQuery allowancesgetCreate allowancepostRetrieve allowancegetUpdate allowanceputDelete allowancedeleteQuery line itemsgetAdd line itempostCancel line itemspostPrepare document creation for certain itemspostSet items on holdpostRetrieve line itemgetEdit line itemputRetrieve contractgetUpdate contractpatchQuery billable itemsgetRetrieve billable itemgetQuery attachmentsgetAdd attachmentpostRetrieve attachmentgetDelete attachmentdeleteUsagesQuery usagesgetCreate usagepostDelete usagesdeleteCancel usagespostRetrieve usagegetBillable ItemsQuery billable itemsgetInvoicesReissue invoicepostOrders (deprecated)Create billable itempostCancel orderpatchCreate credit billable itempostAdd item to closing invoicepostGenerate closing invoicepostAdd purchase itempostCancel purchase itemspostPrepare document creation for certain itemspostSet items on holdpostCancel purchase itempostRetrieve purchase itemgetEdit purchase itemputAdd agreed deposit to purchase itempostContracts (deprecated)Create billable itempostAdd purchase itempostCancel purchase itemspostPrepare document creation for certain itemspostSet items on holdpostRetrieve purchase itemgetEdit purchase itemputAdd agreed deposit to purchase itempostTerminate contract by identpostCancel contractpatchCancel contract itemspostCreate closing invoicepostTerminate contract by idpostCreate credit billable itempostUsage APIRated usagesQuery rated usagesgetCreate rated usagepostRetrieve rated usagegetCancel rated usagepostRetry rated usagepostRated usage aggregationsQuery rated usage aggregationsgetClose rated usage aggregationpostData Access APIInvoicesQuery invoicesgetRetrieve invoicegetInvoice APIDocumentsQuery documentsgetCreate credit memopostRetrieve credit memogetCreate deposit invoice correctionpostRetrieve deposit invoice correctiongetCreate deposit invoicepostRetrieve deposit invoicegetCreate invoicepostRetrieve invoicegetRetrieve document processing status by requestIdgetCreate self billing invoice correctionpostRetrieve self billing invoice correctiongetCreate self billing invoicepostRetrieve self billing invoicegetRetrieve documentgetRetrieve document aggregationsgetDocument LabelsQuery LabelsgetAdd LabelpostRemove LabelpostAggregation ConfigurationsQuery AggregationgetCreate AggregationpostRetrieve AggregationgetUpdate AggregationputDelete AggregationdeleteDocument Number ConfigurationsQuery countersgetCreate counterpostUpdate counterputDelete counterdeleteSearch billing group number strategiesgetCreate billing group number strategypostUpdate billing group number strategyputDelete billing group number strategydeleteGet default number strategygetCreate default number strategypostDelete default number strategydeleteQuery document type number strategiesgetCreate document type number strategypostUpdate document type number strategyputDelete document type number strategydeleteSearch service country number strategiesgetCreate service country number strategypostUpdate service country number strategyputDelete service country number strategydeleteDocument number strategygetSelect document number strategypostDunning ConfigurationsRetrieve dunning configurationgetCreate dunning configurationpostDunning Status AggregationsRetrieve dunning status aggregationgetLists dunning status aggregation documentsgetOperating Site ConfigurationsQuery Operating SitegetCreate Operating SitepostRetrieve Operating SitegetUpdate Operating SiteputDelete Operating SitedeleteMake Operating Site DefaultpostQuery tax registrationsgetCreate tax registrationspostDelete tax registrationsdeleteOPOS CasesQuery OPOS CasesgetRetrieve OPOS CasegetReevaluation of OposCasepostQuery Decisions for OPOS CasesgetAdd Decision for OPOS CasepostRetrieve Decision for OPOS CasegetRevert a Decision for OPOS CasepostSAF-T ConfigurationsQuery Saf-T configurationgetCreate Saf-T configurationpostRetrieve Saf-T configurationgetUpdate Saf-T configurationputDelete Saf-T configurationdeleteTenant ConfigurationsGet polish credit memo flaggetSet polish credit memo flagpostDocument Output APITranslationsStore TranslationspostGet TranslationsgetDelete Translation KeydeleteUpdate TranslationpatchDelete TranslationdeleteTranslation ConfigurationsGet All TranslationsgetGet Configured LocalesgetDocument Creation ConfigurationsRetrieve configurationgetUpdate configurationputFilesRetrieve a filegetRetrieve attachmentsgetRetrieve attachmentgetTax APITax CalculationCalculate tax for a documentpostTax Rules ConfigurationQuery tax rulesgetCreate tax rulepostRetrieve tax rulegetUpdate tax ruleputAdd variant to tax rulepostRetrieve tax rule variantgetTax Provider ConfigurationGet the tax provider configurationsgetCreate or update the tax provider configuration for a countrypostDelete the tax provider configuration for a countrydeleteGet usernames of all present tax provider credentialsgetCreate or update tax provider credentialspostGet username of tax provider credentials if presentgetDelete tax provider credentialsdeleteUpdate tax properties for a providerputCreate tax properties for a providerpostGet tax properties for a providergetDelete tax properties for a providerdeleteGet all enabled tax providers for tenantgetTax Service Tenant ConfigurationGet the tax service configuration for a tenant.getCreate or update the tax service configuration for a tenant.postTax Service Billing Group ConfigurationGet the tax service configuration for a billing group.getCreate or update the tax service configuration for a billing group.postPayment APICustomer Payment AccountsQuery CustomerPaymentAccountgetCreate a CustomerPaymentAccountpostRetrieve a CustomerPaymentAccountgetUpdate a CustomerPaymentAccountputChange health statuspostMerchant Payment AccountsQuery MerchantPaymentAccountgetCreate MerchantPaymentAccountpostRetrieve categorization configurationgetUpdate MerchantPaymentAccountputDelete MerchantPaymentAccountdeleteMerchant Payment GatewaysQuery MerchantPaymentGatewaygetCreate MerchantPaymentGatewaypostUpdate MerchantPaymentGatewayputPayment ProvidersList payment providersgetCreate payment providerpostRetrieve payment providergetDelete payment providerdeleteCreate settlement sourcepostRetrieve settlement sourcegetUpdate settlement sourceputDelete settlement sourcedeletePayment CategoriesQuery payment categoriesgetCreate payment categorypostRetrieve MerchantPaymentAccountgetRetrieve payment categorygetUpdate attributes of payment categorypatchList payment categoriesgetEnable or disable payment categorypatchPayment Categorization ConfigurationRetrieve categorization configurationgetCreate categorization configurationpostUpdate categorization configurationputDelete categorization configuration.deleteRetrieve global payment category configurationgetPayment TransactionsQuery payment transactions for a merchant payment accountgetCreate payment transactionpostRetrieve payment transactiongetUpdate payment transactionpatchUpdate status of the payment transactionpostPayment Categorization RulesCreate a payment categorization rulepostget a payment categorization rulegetUpdate a payment categorization ruleputdelete a payment categorization ruledeleteQuery payment categorization rulesgetPayment IntentsQuery payment intentgetCreate PaymentIntentpostEnable payment intentpostGet processing enabled status.getRetrieve PaymentIntentgetCancel PaymentIntentpostRetry PaymentIntentpostPayment Intent TasksQuery Payment Intent TaskgetEnable payment intent taskspostRetrieve Payment Intent TaskgetSettlementsQuery settlement items per merchant payment accountgetQuery settlement reports by merchant payment accountgetCreate settlement reportpostRetrieve settlement reportgetCreate settlement itempostUpload settlement reportpostQuery settlement reportsgetQuery settlement itemsgetRetrieve settlement itemgetPayment Assignment APIAssignmentsQuery payment assignmentsgetAssign PaymentpostRetrieve payment assignmentgetReverse payment assignmentpostAssignment ConfigurationRetrieve payment account's assignment configurationgetCreate or update payment account's assignment configurationspostDelete payment account assignment configurationsdeleteQuery regex matching strategiesgetCreate regex matching strategypostUpdate regex matching strategyputDelete regex matching strategydeleteBookkeeping APIBooking AccountsRetrieve booking accountsgetCreate booking accountpostRetrieve booking accountsgetUpdate booking accountputRemove booking accountdeleteBooking EntriesQuery booking entriesgetClearingQuery clearingsgetClear booking entriespostRetrieve clearinggetDelete clearingdeleteTenantsGet gain loss configurationgetUpdate gain loss configurationputReport APIReport FilesQuery reports for periodgetDelete reports of perioddeleteQuery reportsgetDownload reportgetDelete reportdeleteNotification APINotificationsQuery notificationsgetResend notificationspostRetrieve notificationgetResend notificationpostNotification ConfigurationGet RoutesgetUpdate Route for Notification ConfigurationputAdd Notification Route ConfigurationpostGet NotificationTypesgetDelete Notification RoutedeleteGet Notification Security ConfigurationgetUpdate Notification Security ConfigurationputCreate Notification Security ConfigurationpostDelete Notification ConfigurationdeleteBasware Adapter APIBasware country configurationGet all Basware country configurationsgetGet Basware country configurationgetUpdate Basware country configurationpostBasware forward route configurationGet All Forward RoutesgetStore Forward RoutepostDelete Forward RoutedeleteBasware credential configurationGet Basware credentials configurationgetCreate or update Basware credentials configurationpostDelete Basware credentials configurationdeleteBasware forward route resolverResolve RoutegetBasware workflowsQuery workflowsgetRetrieve workflowgetRetrigger workflowpostBasware enumsGet used enumerationsgetBilling Preparation APIBilling Group ConfigurationGet billing preparation billing group configgetUpdate billing preparation billing group configpostPowered by Retrieve dunning status aggregationget https://api.nitrobox.io/v2/dunning-status-aggregations/{referenceType}/{referenceIdent}Get the dunning status for a reference type and reference ident.