---
title: "partner/invoices"
method: GET
path: "/partner/invoices"
tags: ["Partner Endpoints"]
---

# partner/invoices

`GET /partner/invoices`

## Request

- Base URL: `https://earthnode-dev.vopay.com/api/v2`
- URL: `https://earthnode-dev.vopay.com/api/v2/partner/invoices`
- Auth: none declared

This endpoint is used to retrieve the list of invoices issued to your partner account. Results can be narrowed by invoice period, currency and a free-text search.

## Query parameters

- `AccountID` string, required
- `Key` string, required
- `Signature` string, required
- `FromDate` string
- `ToDate` string
- `Currency` string
- `SearchText` string

## Response `200`

- object
  - `Success` boolean, required: True if the request was successful, false if it failed
  - `ErrorMessage` string, required: Contains a description of the error if the request failed
  - `PartnerInvoices` object, required: Array serialized as a JSON object (JSON_FORCE_OBJECT): numeric string keys '0','1',... Empty {} when no items.
    - `0` object
      - `InvoiceID` string, required: Unique ID of the invoice
      - `InvoiceNumber` string, required: Invoice number
      - `InvoiceType` string, required: Type of invoice: recurring, setup, termination, credit or monthly fees
      - `InvoiceDate` string, required: Date the invoice was issued (yyyy-mm-dd)
      - `DueDate` string, required: Date the invoice is due (yyyy-mm-dd)
      - `PaymentStatus` string, required: Payment status of the invoice: pending, paid, void or failed
      - `FromDate` string, required: Start of the invoiced period (yyyy-mm-dd)
      - `ToDate` string, required: End of the invoiced period (yyyy-mm-dd)
      - `TaxType` string, nullable, required: Tax applied to the invoice
      - `TaxRate` string, nullable, required: Tax rate applied, as a percentage
      - `TaxTotal` string, nullable, required: Total tax charged
      - `Subtotal` string, nullable, required: Invoice total before tax
      - `Total` string, nullable, required: Invoice total including tax
      - `CurrencyShortForm` string, required: 3 character currency code of the invoice; ex: CAD

## Changes

- **2026-11-03** `71f251deb318`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vopay/apis/accounts/changes/partner/invoices/get.md)

---

[API](https://skmtc.dev/vopay/apis/accounts.md) - [All operations](https://skmtc.dev/vopay/apis/accounts/llms.txt) - [OpenAPI document](https://skmtc.dev/vopay/apis/accounts/revisions/71f251deb318?raw)