GET Api/Invoice?CustomerToken={CustomerToken}&MasterEntityLevel={MasterEntityLevel}&OnlyOneTime={OnlyOneTime}&Page={Page}&PageSize={PageSize}&AmountDueFrom={AmountDueFrom}&AmountDueTo={AmountDueTo}&AsCustomer={AsCustomer}&BillerInvoiceNo={BillerInvoiceNo}&BillingAccountID={BillingAccountID}&CreditMemos={CreditMemos}&DueDateFrom={DueDateFrom}&DueDateTo={DueDateTo}&Filter={Filter}&HasPromise={HasPromise}&HideExpired={HideExpired}&IncludeCreditMemos={IncludeCreditMemos}&InvoiceAgeFrom={InvoiceAgeFrom}&InvoiceAgeTo={InvoiceAgeTo}&InvoiceCategory={InvoiceCategory}&LookbackDate={LookbackDate}&Name={Name}&OtherData={OtherData}&ReferenceNumber={ReferenceNumber}&Sort={Sort}&StatementDateFrom={StatementDateFrom}&StatementDateTo={StatementDateTo}&Type={Type}&DisplayField1={DisplayField1}&DisplayField2={DisplayField2}&DisplayField3={DisplayField3}&DisplayField4={DisplayField4}&DisplayField5={DisplayField5}

Searches for an existing invoice in the system.

Request Information

URI Parameters

Name	Description	Type	Additional information
AmountDueFrom		decimal?	None.
AmountDueTo		decimal?	None.
AsCustomer		boolean	None.
BillerInvoiceNo		string	String length: inclusive between 0 and 50
BillingAccountID		long?	None.
CreditMemos		boolean	None.
CustomerToken	For enrolled invoice search requests, contains the unique customer token used to identify the customer performing the search.	string	None.
DueDateFrom		date-time?	None.
DueDateTo		date-time?	None.
Filter		string	String length: inclusive between 0 and 2048
HasPromise		boolean?	None.
HideExpired		boolean	None.
IncludeCreditMemos		boolean	None.
InvoiceAgeFrom		int?	None.
InvoiceAgeTo		int?	None.
InvoiceCategory		InvoiceCategory	None.
LookbackDate		date-time?	None.
MasterEntityLevel	If set to True, will cause all the invoices for all billing accounts under the ME to be returned when searching for a billing account under and ME.	boolean?	None.
Name		string	String length: inclusive between 0 and 100
OnlyOneTime	Force invoice search to look up as a one-time customer only, regardless of any enrolled customers against the account.	boolean	None.
OtherData		string	String length: inclusive between 0 and 256
Page	Specifies the page to return in the result set. Defaults to 1.	int?	None.
PageSize	Specifies the number of records to return per-page. Defaults to 50.	int?	None.
ReferenceNumber		string	String length: inclusive between 0 and 256
Sort		string	String length: inclusive between 0 and 100
StatementDateFrom		date-time?	None.
StatementDateTo		date-time?	None.
Type		InvoiceViewType	None.

Body Parameters

None.

Response Information

Resource Description

Searches for an existing invoice in the system.

APIInvoiceSearchResponseModel

Name	Description	Type	Additional information
ErrorCode	Name of the error condition. See ErrorCode model for details.	ErrorCode	None.
ErrorID	Internal error identification number that uniquely identifies this specific error that occurred.	string	None.
ErrorNum	Numeric value of the ErrorCode	int	None.
Errors	List of errors that occurred when performing the requested operation.	Collection of string	None.
Result		InvoicesCompositeModel	None.
Success	Indicates sucess or failure of the REST request.	boolean	None.

Response Formats

application/json, text/json

Sample:

{
  "ErrorCode": "None",
  "ErrorID": "sample string 1",
  "ErrorNum": 0,
  "Errors": [
    "sample string 1",
    "sample string 2"
  ],
  "Result": {
    "InvoiceCount": 1,
    "Invoices": [
      {
        "ActivePaymentAmount": 1.0,
        "AdditionalFields": [
          {
            "BillerId": 1,
            "FieldName": "sample string 2",
            "FieldOrder": 3,
            "FieldText": "sample string 4",
            "FieldValue": "sample string 5",
            "ID": 6,
            "InvoiceId": 7,
            "IsEditable": true,
            "IsRequired": true,
            "SearchOnPMB": true
          },
          {
            "BillerId": 1,
            "FieldName": "sample string 2",
            "FieldOrder": 3,
            "FieldText": "sample string 4",
            "FieldValue": "sample string 5",
            "ID": 6,
            "InvoiceId": 7,
            "IsEditable": true,
            "IsRequired": true,
            "SearchOnPMB": true
          }
        ],
        "AmountRemaining": 1.0,
        "BillID": 42,
        "BillingAccountID": 2,
        "DecryptedReferenceNumber": "sample string 96",
        "DefaultPaymentAmount": 3.0,
        "DiscountRate": 4.0,
        "DisplayPaymentAmountOptions": true,
        "DisputedAmount": 1.0,
        "DisputeCount": 6,
        "dtDue": "2026-06-18T21:44:01.7051786Z",
        "dtStatement": "2026-06-18T21:44:01.7367876Z",
        "HasCreditMemoPayments": true,
        "HasOpenRFP": true,
        "HasPayments": true,
        "InvoiceStatus": "Active",
        "IsCreditMemo": true,
        "IsExpired": false,
        "IsPaidOther": false,
        "IsPartiallyApplied": true,
        "IsPayable": true,
        "IsReadOnly": false,
        "PaymentAmountOptions": {
          "MinimumPaymentAmount": 1.0
        },
        "PaymentInstrumentBlock": [
          "sample string 1",
          "sample string 2"
        ],
        "PaymentInstrumentBlockDescriptor": "sample string 13",
        "Stopped": true,
        "TaxType": "sample string 15",
        "Address": "sample string 16",
        "Address2": "sample string 17",
        "AttnAddressLine": "sample string 18",
        "AmountDue": 1.0,
        "BillerInvoiceNo": "sample string 19",
        "BillerRemittanceField1": "sample string 20",
        "BillerRemittanceField2": "sample string 21",
        "BillerRemittanceField3": "sample string 22",
        "BillerRemittanceField4": "sample string 23",
        "BillerRemittanceField5": "sample string 24",
        "City": "sample string 25",
        "CompanyName": "sample string 26",
        "Country": "sample string 27",
        "CurrentCharges": 1.0,
        "CustomAttributes": {
          "sample string 1": "sample string 2",
          "sample string 3": "sample string 4"
        },
        "DisplayField1": "sample string 28",
        "DisplayField2": "sample string 29",
        "DisplayField3": "sample string 30",
        "DisplayField4": "sample string 31",
        "DisplayField5": "sample string 32",
        "DueDate": "2026-06-18T21:44:01.7051786Z",
        "Email": "test1@test.com",
        "EntryField1": "sample string 33",
        "EntryField2": "sample string 34",
        "EntryField3": "sample string 35",
        "EntryField4": "sample string 36",
        "EntryField5": "sample string 37",
        "ExternalID": "sample string 38",
        "Fax": "sample string 39",
        "FDICode": "sample string 40",
        "FirstName": "sample string 41",
        "ID": 42,
        "InvoiceAge": 43,
        "InvoiceCategory": "Invoice",
        "InvAltTaxAmount": 1.0,
        "InvAltTaxAmtItmLevel": 1.0,
        "InvAltTaxIdItmLevel": "sample string 44",
        "InvAltTaxIDOrdLevel": "sample string 45",
        "InvAltTaxID": "sample string 46",
        "InvAltTaxRate": "sample string 47",
        "InvAltTaxType": "sample string 48",
        "InvAltTaxTypeApp": "sample string 49",
        "InvCommodityCode": "sample string 50",
        "InvCustomerCode": "sample string 51",
        "InvDestAddress1": "sample string 52",
        "InvDestAddress2": "sample string 53",
        "InvDestCardholderName": "sample string 54",
        "InvDestCity": "sample string 55",
        "InvDestCountryCode": "sample string 56",
        "InvDestStateCode": "sample string 57",
        "InvDestZipCode": "sample string 58",
        "InvDiscountPerItem": 1.0,
        "InvDutyAmount": 1.0,
        "InvFreightAmount": 1.0,
        "InvLineItemTotal": 1.0,
        "InvLineItemDiscountRate": "sample string 59",
        "InvLineItemTaxRate": "sample string 60",
        "InvLineItemVATTaxAmount": 1.0,
        "InvLineItemVATTaxRate": "sample string 61",
        "InvLocalTaxAmount": 1.0,
        "InvLocalTaxItmLevel": 1.0,
        "InvLocalTaxRate": "sample string 62",
        "InvMerchantVATRegistrationNumber": "sample string 63",
        "InvNationalTaxAmount": 1.0,
        "InvNationalTaxItmLevel": 1.0,
        "InvNationalTaxRate": "sample string 64",
        "InvNetGrossIndicator": "sample string 65",
        "InvOrderDisAmtOrdLevel": "sample string 66",
        "InvProductCode": "sample string 67",
        "InvProductName": "sample string 68",
        "InvProductSKU": "sample string 69",
        "InvPurchaseID": "sample string 70",
        "InvPurchaseIDItmLevel": "sample string 71",
        "InvPstTaxRegNum": "sample string 72",
        "InvRequestorName": "sample string 73",
        "InvQuantity": 1,
        "InvShipFromZipCode": "sample string 74",
        "InvSummaryCommodityCode": "sample string 75",
        "InvSupplierOrdRef": "sample string 76",
        "InvTaxAmount": 1.0,
        "InvTaxRate": "sample string 77",
        "InvUnitCost": 1.0,
        "InvUnitMeasure": "sample string 78",
        "InvVatRefNumber": "sample string 79",
        "InvVatRegNumber": "sample string 80",
        "InvVatTaxAmount": 1.0,
        "InvVatTaxRate": "sample string 81",
        "ItemQuantity": 1.0,
        "LastName": "sample string 82",
        "MerchantDescriptor": "sample string 83",
        "MerchantDescriptorAlt": "sample string 84",
        "MerchantDescriptorCity": "sample string 85",
        "MerchantDescriptorContact": "sample string 86",
        "MerchantDescriptorCountry": "sample string 87",
        "MerchantDescriptorState": "sample string 88",
        "MerchantDescriptorStreet": "sample string 89",
        "MerchantDescriptorZip": "sample string 90",
        "Message_OutstandingBalance": "sample string 91",
        "MiddleName": "sample string 92",
        "MinimumAmountDue": 1.0,
        "OtherData": "sample string 93",
        "PaymentReceived": 1.0,
        "PaymentsPostedAsOfDate": "2026-06-18T21:44:01.7252774Z",
        "PayThisAmount": 1.0,
        "Phone": "sample string 95",
        "Prev_0To30Days": 1.0,
        "Prev_30To60Days": 1.0,
        "Prev_60To90Days": 1.0,
        "Prev_90DaysPlus": 1.0,
        "PreviousBalance": 1.0,
        "Promise": {
          "PromiseDate": "2026-06-18T21:44:01.7367876Z",
          "PromiseStatus": "Initiated"
        },
        "ReferenceNumber": "sample string 96",
        "State": "sample string 97",
        "StatementDate": "2026-06-18T21:44:01.7367876Z",
        "Status": "Active",
        "TotalAccountBalance": 1.0,
        "Zip": "sample string 98"
      },
      {
        "ActivePaymentAmount": 1.0,
        "AdditionalFields": [
          {
            "BillerId": 1,
            "FieldName": "sample string 2",
            "FieldOrder": 3,
            "FieldText": "sample string 4",
            "FieldValue": "sample string 5",
            "ID": 6,
            "InvoiceId": 7,
            "IsEditable": true,
            "IsRequired": true,
            "SearchOnPMB": true
          },
          {
            "BillerId": 1,
            "FieldName": "sample string 2",
            "FieldOrder": 3,
            "FieldText": "sample string 4",
            "FieldValue": "sample string 5",
            "ID": 6,
            "InvoiceId": 7,
            "IsEditable": true,
            "IsRequired": true,
            "SearchOnPMB": true
          }
        ],
        "AmountRemaining": 1.0,
        "BillID": 42,
        "BillingAccountID": 2,
        "DecryptedReferenceNumber": "sample string 96",
        "DefaultPaymentAmount": 3.0,
        "DiscountRate": 4.0,
        "DisplayPaymentAmountOptions": true,
        "DisputedAmount": 1.0,
        "DisputeCount": 6,
        "dtDue": "2026-06-18T21:44:01.7051786Z",
        "dtStatement": "2026-06-18T21:44:01.7367876Z",
        "HasCreditMemoPayments": true,
        "HasOpenRFP": true,
        "HasPayments": true,
        "InvoiceStatus": "Active",
        "IsCreditMemo": true,
        "IsExpired": false,
        "IsPaidOther": false,
        "IsPartiallyApplied": true,
        "IsPayable": true,
        "IsReadOnly": false,
        "PaymentAmountOptions": {
          "MinimumPaymentAmount": 1.0
        },
        "PaymentInstrumentBlock": [
          "sample string 1",
          "sample string 2"
        ],
        "PaymentInstrumentBlockDescriptor": "sample string 13",
        "Stopped": true,
        "TaxType": "sample string 15",
        "Address": "sample string 16",
        "Address2": "sample string 17",
        "AttnAddressLine": "sample string 18",
        "AmountDue": 1.0,
        "BillerInvoiceNo": "sample string 19",
        "BillerRemittanceField1": "sample string 20",
        "BillerRemittanceField2": "sample string 21",
        "BillerRemittanceField3": "sample string 22",
        "BillerRemittanceField4": "sample string 23",
        "BillerRemittanceField5": "sample string 24",
        "City": "sample string 25",
        "CompanyName": "sample string 26",
        "Country": "sample string 27",
        "CurrentCharges": 1.0,
        "CustomAttributes": {
          "sample string 1": "sample string 2",
          "sample string 3": "sample string 4"
        },
        "DisplayField1": "sample string 28",
        "DisplayField2": "sample string 29",
        "DisplayField3": "sample string 30",
        "DisplayField4": "sample string 31",
        "DisplayField5": "sample string 32",
        "DueDate": "2026-06-18T21:44:01.7051786Z",
        "Email": "test1@test.com",
        "EntryField1": "sample string 33",
        "EntryField2": "sample string 34",
        "EntryField3": "sample string 35",
        "EntryField4": "sample string 36",
        "EntryField5": "sample string 37",
        "ExternalID": "sample string 38",
        "Fax": "sample string 39",
        "FDICode": "sample string 40",
        "FirstName": "sample string 41",
        "ID": 42,
        "InvoiceAge": 43,
        "InvoiceCategory": "Invoice",
        "InvAltTaxAmount": 1.0,
        "InvAltTaxAmtItmLevel": 1.0,
        "InvAltTaxIdItmLevel": "sample string 44",
        "InvAltTaxIDOrdLevel": "sample string 45",
        "InvAltTaxID": "sample string 46",
        "InvAltTaxRate": "sample string 47",
        "InvAltTaxType": "sample string 48",
        "InvAltTaxTypeApp": "sample string 49",
        "InvCommodityCode": "sample string 50",
        "InvCustomerCode": "sample string 51",
        "InvDestAddress1": "sample string 52",
        "InvDestAddress2": "sample string 53",
        "InvDestCardholderName": "sample string 54",
        "InvDestCity": "sample string 55",
        "InvDestCountryCode": "sample string 56",
        "InvDestStateCode": "sample string 57",
        "InvDestZipCode": "sample string 58",
        "InvDiscountPerItem": 1.0,
        "InvDutyAmount": 1.0,
        "InvFreightAmount": 1.0,
        "InvLineItemTotal": 1.0,
        "InvLineItemDiscountRate": "sample string 59",
        "InvLineItemTaxRate": "sample string 60",
        "InvLineItemVATTaxAmount": 1.0,
        "InvLineItemVATTaxRate": "sample string 61",
        "InvLocalTaxAmount": 1.0,
        "InvLocalTaxItmLevel": 1.0,
        "InvLocalTaxRate": "sample string 62",
        "InvMerchantVATRegistrationNumber": "sample string 63",
        "InvNationalTaxAmount": 1.0,
        "InvNationalTaxItmLevel": 1.0,
        "InvNationalTaxRate": "sample string 64",
        "InvNetGrossIndicator": "sample string 65",
        "InvOrderDisAmtOrdLevel": "sample string 66",
        "InvProductCode": "sample string 67",
        "InvProductName": "sample string 68",
        "InvProductSKU": "sample string 69",
        "InvPurchaseID": "sample string 70",
        "InvPurchaseIDItmLevel": "sample string 71",
        "InvPstTaxRegNum": "sample string 72",
        "InvRequestorName": "sample string 73",
        "InvQuantity": 1,
        "InvShipFromZipCode": "sample string 74",
        "InvSummaryCommodityCode": "sample string 75",
        "InvSupplierOrdRef": "sample string 76",
        "InvTaxAmount": 1.0,
        "InvTaxRate": "sample string 77",
        "InvUnitCost": 1.0,
        "InvUnitMeasure": "sample string 78",
        "InvVatRefNumber": "sample string 79",
        "InvVatRegNumber": "sample string 80",
        "InvVatTaxAmount": 1.0,
        "InvVatTaxRate": "sample string 81",
        "ItemQuantity": 1.0,
        "LastName": "sample string 82",
        "MerchantDescriptor": "sample string 83",
        "MerchantDescriptorAlt": "sample string 84",
        "MerchantDescriptorCity": "sample string 85",
        "MerchantDescriptorContact": "sample string 86",
        "MerchantDescriptorCountry": "sample string 87",
        "MerchantDescriptorState": "sample string 88",
        "MerchantDescriptorStreet": "sample string 89",
        "MerchantDescriptorZip": "sample string 90",
        "Message_OutstandingBalance": "sample string 91",
        "MiddleName": "sample string 92",
        "MinimumAmountDue": 1.0,
        "OtherData": "sample string 93",
        "PaymentReceived": 1.0,
        "PaymentsPostedAsOfDate": "2026-06-18T21:44:01.7252774Z",
        "PayThisAmount": 1.0,
        "Phone": "sample string 95",
        "Prev_0To30Days": 1.0,
        "Prev_30To60Days": 1.0,
        "Prev_60To90Days": 1.0,
        "Prev_90DaysPlus": 1.0,
        "PreviousBalance": 1.0,
        "Promise": {
          "PromiseDate": "2026-06-18T21:44:01.7367876Z",
          "PromiseStatus": "Initiated"
        },
        "ReferenceNumber": "sample string 96",
        "State": "sample string 97",
        "StatementDate": "2026-06-18T21:44:01.7367876Z",
        "Status": "Active",
        "TotalAccountBalance": 1.0,
        "Zip": "sample string 98"
      }
    ],
    "TotalBalance": 2.0
  },
  "Success": true
}