Search Invoices for Customer

curl --request GET \
  --url https://api.revolv3.com/api/Customers/{customerId}/invoices \
  --header 'Authorization: Bearer <token>'

[
  {
    "invoiceId": 1,
    "customerId": null,
    "merchantInvoiceRefId": "1234-5678-9101",
    "binNumber": "411111",
    "last4Digit": "1111",
    "invoiceStatus": "Pending",
    "subtotal": 60.99,
    "tax": 5.4,
    "total": 66.39,
    "billingDate": "17-Oct-25",
    "merchantLegalName": null,
    "merchantCustomerRefId": null,
    "customerFirstName": null,
    "customerLastName": null
  },
  {
    "invoiceId": 2,
    "customerId": null,
    "merchantInvoiceRefId": "1234-5678-9101",
    "binNumber": "411111",
    "last4Digit": "1111",
    "invoiceStatus": "Pending",
    "subtotal": 40.99,
    "tax": 3.6,
    "total": 43.59,
    "billingDate": "17-Nov-25",
    "merchantLegalName": null,
    "merchantCustomerRefId": null,
    "customerFirstName": null,
    "customerLastName": null
  }
]

Customers

Search Invoices for Customer

Searches for invoices associated with a specific customer, using optional filters such as Merchant Customer Ref ID, Merchant Invoice Ref ID, start date, and end date. The filter applies to the billing date of each invoice.

Results are returned in a paginated format using the Page and PageSize query parameters. If not specified, page 1 is returned with up to 100 results. The maximum supported PageSize is 100 entries per request. Use this endpoint to retrieve a customer’s invoice history, monitor billing activity, or generate reports for specific periods or identifiers.

Returns 404 Not Found if the Customer ID does not exist, or 400 Bad Request for invalid date inputs.

GET

api

Customers

{customerId}

invoices

Search Invoices for Customer

curl --request GET \
  --url https://api.revolv3.com/api/Customers/{customerId}/invoices \
  --header 'Authorization: Bearer <token>'

[
  {
    "invoiceId": 1,
    "customerId": null,
    "merchantInvoiceRefId": "1234-5678-9101",
    "binNumber": "411111",
    "last4Digit": "1111",
    "invoiceStatus": "Pending",
    "subtotal": 60.99,
    "tax": 5.4,
    "total": 66.39,
    "billingDate": "17-Oct-25",
    "merchantLegalName": null,
    "merchantCustomerRefId": null,
    "customerFirstName": null,
    "customerLastName": null
  },
  {
    "invoiceId": 2,
    "customerId": null,
    "merchantInvoiceRefId": "1234-5678-9101",
    "binNumber": "411111",
    "last4Digit": "1111",
    "invoiceStatus": "Pending",
    "subtotal": 40.99,
    "tax": 3.6,
    "total": 43.59,
    "billingDate": "17-Nov-25",
    "merchantLegalName": null,
    "merchantCustomerRefId": null,
    "customerFirstName": null,
    "customerLastName": null
  }
]

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

customerId

integer<int64>

required

Query Parameters

merchantCustomerRefId

string

merchantInvoiceRefId

string

startDate

string

endDate

string

page

integer<int32>

pageSize

integer<int32>

Response

invoiceId

integer<int64>

parentInvoiceId

integer<int64> | null

customerId

integer<int64> | null

merchantInvoiceRefId

string | null

paymentMethod

object

Show child attributes

paymentMethod.paymentMethodId

integer<int64>

paymentMethod.billingAddressId

integer<int64>

paymentMethod.billingAddress

object

Show child attributes

paymentMethod.billingAddress.addressId

integer<int64>

paymentMethod.billingAddress.addressLine1

string | null

paymentMethod.billingAddress.addressLine2

string | null

paymentMethod.billingAddress.city

string | null

paymentMethod.billingAddress.state

string | null

paymentMethod.billingAddress.postalCode

string | null

paymentMethod.billingAddress.phoneNumber

string | null

paymentMethod.billingAddress.email

string | null

paymentMethod.billingAddress.country

string | null

paymentMethod.billingFirstName

string | null

paymentMethod.billingLastName

string | null

paymentMethod.merchantPaymentMethodRefId

string | null

paymentMethod.paymentMethodAchDetails

object

Show child attributes

paymentMethod.paymentMethodAchDetails.accountNumberLast4Digits

string | null

paymentMethod.paymentMethodAchDetails.accountNumberLength

integer<int32>

paymentMethod.paymentMethodAchDetails.accountType

string | null

paymentMethod.paymentMethodCreditCardDetails

object

Show child attributes

paymentMethod.paymentMethodCreditCardDetails.binNumber

string | null

paymentMethod.paymentMethodCreditCardDetails.paymentLast4Digit

string | null

paymentMethod.paymentMethodCreditCardDetails.paymentExpirationDate

string | null

paymentMethod.paymentMethodCreditCardDetails.accountUpdateMessage

string | null

paymentMethod.paymentMethodCreditCardDetails.accountUpdateDateTime

string | null

invoiceStatus

string | null

subtotal

number<double>

tax

number<double>

total

number<double>

billingDate

string | null

merchantLegalName

string | null

merchantCustomerRefId

string | null

customerFirstName

string | null

customerLastName

string | null

subscriptionId

integer<int64> | null

installmentId

integer<int64> | null

eligibilityFailReason

string | null

merchantSubscriptionRefId

string | null

networkTransactionId

string | null

currency

string | null

invoiceLineItems

object[] | null

Show child attributes

invoiceLineItems.invoiceLineItemId

integer<int64>

invoiceLineItems.name

string | null

invoiceLineItems.description

string | null

invoiceLineItems.value

number<double>

invoiceLineItems.valueType

string | null

invoiceLineItems.billingValueType

enum<string>

Available options:

Standard,

Discount,

DiscountPercentage,

FinalDiscount,

PriceOverride

invoiceLineItems.invoiceId

integer<int64>

invoiceAttempts

object[] | null

Show child attributes

invoiceAttempts.invoiceAttemptId

integer<int64>

invoiceAttempts.amount

number<double>

invoiceAttempts.invoiceAttemptStatus

string | null

invoiceAttempts.invoiceAttemptDate

string<date-time>

invoiceAttempts.paymentProcessor

string | null

invoiceAttempts.processorTransactionId

string | null

invoiceAttempts.responseCode

string | null

invoiceAttempts.responseMessage

string | null

invoiceAttempts.processorRawResponse

string | null

invoiceAttempts.paymentMethod

object

Show child attributes

invoiceAttempts.paymentMethod.paymentMethodId

integer<int64>

invoiceAttempts.paymentMethod.billingAddressId

integer<int64>

invoiceAttempts.paymentMethod.billingAddress

object

Show child attributes

invoiceAttempts.paymentMethod.billingAddress.addressId

integer<int64>

invoiceAttempts.paymentMethod.billingAddress.addressLine1

string | null

invoiceAttempts.paymentMethod.billingAddress.addressLine2

string | null

invoiceAttempts.paymentMethod.billingAddress.city

string | null

invoiceAttempts.paymentMethod.billingAddress.state

string | null

invoiceAttempts.paymentMethod.billingAddress.postalCode

string | null

invoiceAttempts.paymentMethod.billingAddress.phoneNumber

string | null

invoiceAttempts.paymentMethod.billingAddress.email

string | null

invoiceAttempts.paymentMethod.billingAddress.country

string | null

invoiceAttempts.paymentMethod.billingFirstName

string | null

invoiceAttempts.paymentMethod.billingLastName

string | null

invoiceAttempts.paymentMethod.merchantPaymentMethodRefId

string | null

invoiceAttempts.paymentMethod.paymentMethodAchDetails

object

Show child attributes

invoiceAttempts.paymentMethod.paymentMethodAchDetails.accountNumberLast4Digits

string | null

invoiceAttempts.paymentMethod.paymentMethodAchDetails.accountNumberLength

integer<int32>

invoiceAttempts.paymentMethod.paymentMethodAchDetails.accountType

string | null

invoiceAttempts.paymentMethod.paymentMethodCreditCardDetails

object

Show child attributes

invoiceAttempts.paymentMethod.paymentMethodCreditCardDetails.binNumber

string | null

invoiceAttempts.paymentMethod.paymentMethodCreditCardDetails.paymentLast4Digit

string | null

invoiceAttempts.paymentMethod.paymentMethodCreditCardDetails.paymentExpirationDate

string | null

invoiceAttempts.paymentMethod.paymentMethodCreditCardDetails.accountUpdateMessage

string | null

invoiceAttempts.paymentMethod.paymentMethodCreditCardDetails.accountUpdateDateTime

string | null

invoiceAttempts.descriptor

object

Show child attributes

invoiceAttempts.descriptor.subMerchantId

string | null

invoiceAttempts.descriptor.subMerchantName

string | null

invoiceAttempts.descriptor.subMerchantPhone

string | null

invoiceAttempts.descriptor.countryCode

string | null

invoiceAttempts.descriptor.city

string | null

invoiceAttempts.eligibilityCheckOrderCode

string | null

invoiceAttempts.processorMerchantId

string | null

invoiceAttempts.processingMethod

string | null

invoiceStatusEnum

enum<string>

Available options:

Paid,

Void,

Pending,

Recycle,

Noncollectable,

Failed,

Refund,

MerchantPaid,

MerchantCancelled,

OneTimePaymentPending,

PartialRefund,

BatchPending,

CapturePending,

RefundPending,

RefundDeclined,

RefundFailed,

RetryPending,

RecurringPending,

MultiCardsPending

Add Customer Address Get Invoices

⌘I

AccountVerification

Authentication

Checkout

Customers

Invoices

PaymentMethod

Payments

Subscriptions

Search Invoices for Customer

Authorizations

Path Parameters

Query Parameters

Response