---
title: "GET /billing/org/v1/erp-invoices"
method: GET
path: "/billing/org/v1/erp-invoices"
tags: ["erp-invoices"]
---

# GET /billing/org/v1/erp-invoices

`GET /billing/org/v1/erp-invoices`

Mixin for viewsets that provides a queryset based on a model class.

## Query parameters

- `billing_period_from__from` string, date
- `billing_period_to__to` string, date
- `client_id` number
- `currency` string
- `invoice_date__from` string, date
- `invoice_date__to` string, date
- `limit` integer
- `move_type` 'out_invoice' | 'out_refund'
- `offset` integer
- `ordering` string[]
- `payer_id` number
- `payment_state` 'in_payment' | 'not_paid' | 'paid' | 'partial' | 'reversed'

## Response `200`

Request successful.

- PaginatedErpInvoiceExternalList
  - `count` integer, required
  - `next` string, uri, nullable
  - `previous` string, uri, nullable
  - `results` ErpInvoiceExternal[], required
    - `id` integer, required
    - `name` string, required — Invoice number, e.g. INV/2026/00001
    - `move_type` 'out_invoice' | 'out_refund', required — - `out_invoice` - `out_invoice` - `out_refund` - `out_refund`
    - `currency` string, required — Currency code: USD, EUR, etc.
    - `invoice_date` string, date, nullable, required
    - `invoice_date_due` string, date, nullable, required
    - `billing_period_from` string, date, nullable, required
    - `billing_period_to` string, date, nullable, required
    - `amount_untaxed` string, decimal, required — Amount without tax
    - `amount_tax` string, decimal, required — Tax amount
    - `amount_total` string, decimal, required — Total amount with tax
    - `payment_state` 'not_paid' | 'paid' | 'partial' | 'reversed' | 'in_payment', required — - `not_paid` - `not_paid` - `paid` - paid - `partial` - partial - `reversed` - reversed - `in_payment` - `in_payment`
    - `client_id` integer, required — ID of client in API service
    - `payer_id` integer, required
    - `invoice_id` integer, nullable, required — Linked billing system invoice
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `401` — Authentication credentials were not provided or are invalid.
- `403` — You do not have permission to perform this action.

---

[API](https://skmtc.dev/g-core/apis/gcore-openapi.md) · [All operations](https://skmtc.dev/g-core/apis/gcore-openapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/g-core/gcore-openapi/revisions/09e652815095/schema)