Get Invoices V1

curl --request GET \
  --url https://api.revolv3.com/api/Invoices/v{version} \
  --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
  }
]

Invoices

Get Invoices V1

Returns a detailed list of invoices using the latest version of our invoice retrieval logic. This endpoint provides comprehensive invoice information, including status, payment attempts, raw processor responses (if enabled), and additional filtering options available beyond the legacy version.

It supports flexible search by merchant customer reference, billing timestamps, and update timestamps. Pagination is supported via Page and PageSize query parameters — with a maximum of 100 entries per page. If not specified, the default is page 1 with 100 results.

Use this endpoint to power dashboards, reporting tools, or reconciliation processes requiring complete invoice details. This is the recommended endpoint for retrieving invoices moving forward.

GET

api

Invoices

{version}

Get Invoices V1

curl --request GET \
  --url https://api.revolv3.com/api/Invoices/v{version} \
  --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

version

string

required

Query Parameters

merchantCustomerRefId

string

billingStartDate

string

billingEndDate

string

lastUpdateStartDate

string

lastUpdateEndDate

string

lastAttemptOnly

boolean

includeRawProcessorResponse

boolean

page

integer<int32>

pageSize

integer<int32>

orderBy

enum<string>

Available options:

BillingDate,

LastUpdateDate,

InvoiceId

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

Get Invoices Get Invoice

⌘I

AccountVerification

Authentication

Checkout

Customers

Invoices

PaymentMethod

Payments

Subscriptions

Get Invoices V1

Authorizations

Path Parameters

Query Parameters

Response