---
title: "Invoice list"
url: "https://help.internetx.com/en/api/core-invoice-list/"
lang: "en"
section: "API reference — API reference (XML/JSON)"
breadcrumb: "API documentation (JSON/XML) > Tasks"
updated: "2023-09-18"
---

# Invoice list

## Function

The  _InvoiceList_ task inqired incoices .

You can find more information about list queries [here](/en/api/core-list-inquire/). 

## Description

Route: POST /invoice/\_search  

**Query parameters**

The data of the following keywords can be queried with the query parameter ?keys\[\]=:

-   addon
-   created
-   currency
-   failed
-   id
-   number
-   payment
-   status
-   type
-   updated

```
{
	"filters": [
		{
			"key": "number",
			"value": "*",
			"operator": "LIKE"
		}
	],
	"view": {
		"children": 1,
		"limit": 2,
		"from": "2019-11-01T00:00:00.000+0000",
		"to": "2021-11-31T00:00:00.000+0000"
	}
}
```

```
{
    "stid": "20220713-app2-dev-7251",
    "status": {
        "code": "S0885",
        "text": "The invoices were inquired successfully.",
        "type": "SUCCESS"
    },
    "object": {
        "type": "Invoice",
        "summary": 3228
    },
    "data": [
        {
            "created": "2019-11-07T04:00:57.000+0100",
            "updated": "2019-11-07T16:15:21.000+0100",
            "id": 441,
            "number": "40000017",
            "customer": {
                "number": 123456,
                "client": "ix"
            },
            "payment": "POST",
            "paymentMode": "WIRETRANSFER",
            "subType": "DOMAIN",
            "amount": 285.94,
            "vatAmount": 45.65,
            "status": "FINISHED",
            "type": "INVOICE",
            "failed": false,
            "currency": "EUR",
            "document": {
                "id": 5201
            },
            "addon": {
                "documentstore_csv_id": "5202",
                "neo_rechnungs_id": "1524486",
                "documentstore_txt_id": null
            }
        },
        {
            "created": "2019-11-07T04:00:59.000+0100",
            "updated": "2019-11-07T16:15:21.000+0100",
            "id": 442,
            "number": "70001712",
            "customer": {
                "number": 123456,
                "client": "ix"
            },
            "payment": "POST",
            "paymentMode": "WIRETRANSFER",
            "subType": "DOMAIN",
            "amount": 5224.9,
            "vatAmount": 834.23,
            "status": "FINISHED",
            "type": "INVOICE",
            "failed": false,
            "currency": "EUR",
            "document": {
                "id": 5203
            },
            "addon": {
                "documentstore_csv_id": "5204",
                "neo_rechnungs_id": "1524487",
                "documentstore_txt_id": null
            }
        }
    ]
}
```

Auftragstyp-Code: 0885  
Verwendet Objekt Invoice

**Keywords**

The following keywords are returned by default:

-   addon
-   created
-   currency
-   extension
-   failed
-   id
-   number
-   payment
-   status
-   type
-   updated

```
<request>
	<auth>
		<user>customer</user>
		<context>4</context>
		<password>password</password>
	</auth>
	<task>
		<code>0885</code>
		<view>
			<limit>10</limit>
			<offset>0</offset>
			<from>2019-01-01 00:00:00</from>
			<to>2050-12-31 23:59:59</to>
		</view>
		<where>
			<key>number</key>
			<operator>LIKE</operator>
			<value>*</value>
		</where>
	</task>
</request>
```

```
<response>
	<result>
		<data>
			<summary>3</summary>
			<invoice>
				<id>722</id>
				<number>70002356</number>
				<customer>
					<number>1351122086</number>
					<client>ix</client>
				</customer>
				<payment>POST</payment>
				<payment_mode><![CDATA[elv]]></payment_mode>
				<sub_type><![CDATA[DOMAIN]]></sub_type>
				<amount>188.64</amount>
				<vat_amount>30.12</vat_amount>
				<status>FINISHED</status>
				<type>INVOICE</type>
				<failed>0</failed>
				<currency>EUR</currency>
				<document>
					<id>12057</id>
				</document>
				<addon>
					<neo_rechnungs_id>1582355</neo_rechnungs_id>
					<documentstore_csv_id>12058</documentstore_csv_id>
				</addon>
				<extension>
					<documentstore_txt_id/>
					<documentstore_csv_id>12058</documentstore_csv_id>
					<neo_rechnungs_id>1582355</neo_rechnungs_id>
				</extension>
				<created>2020-12-07 04:00:08</created>
				<updated>2020-12-07 11:16:18</updated>
			</invoice>
			<invoice>
				<id>735</id>
				<number>70002397</number>
				<customer>
					<number>1351122086</number>
					<client>ix</client>
				</customer>
				<payment>POST</payment>
				<payment_mode><![CDATA[elv]]></payment_mode>
				<sub_type><![CDATA[DOMAIN]]></sub_type>
				<amount>29.96</amount>
				<vat_amount>4.78</vat_amount>
				<status>FINISHED</status>
				<type>INVOICE</type>
				<failed>0</failed>
				<currency>EUR</currency>
				<document>
					<id>12437</id>
				</document>
				<addon>
					<neo_rechnungs_id>1602609</neo_rechnungs_id>
					<documentstore_csv_id>12438</documentstore_csv_id>
				</addon>
				<extension>
					<documentstore_txt_id/>
					<documentstore_csv_id>12438</documentstore_csv_id>
					<neo_rechnungs_id>1602609</neo_rechnungs_id>
				</extension>
				<created>2020-12-31 04:00:09</created>
				<updated>2020-12-31 12:42:35</updated>
			</invoice>
			<invoice>
				<id>748</id>
				<number>70002414</number>
				<customer>
					<number>1351122086</number>
					<client>ix</client>
				</customer>
				<payment>POST</payment>
				<payment_mode><![CDATA[elv]]></payment_mode>
				<sub_type><![CDATA[DOMAIN]]></sub_type>
				<amount>188.64</amount>
				<vat_amount>30.12</vat_amount>
				<status>FINISHED</status>
				<type>INVOICE</type>
				<failed>0</failed>
				<currency>EUR</currency>
				<document>
					<id>12541</id>
				</document>
				<addon>
					<neo_rechnungs_id>1603431</neo_rechnungs_id>
					<documentstore_csv_id>12542</documentstore_csv_id>
				</addon>
				<extension>
					<documentstore_txt_id/>
					<documentstore_csv_id>12542</documentstore_csv_id>
					<neo_rechnungs_id>1603431</neo_rechnungs_id>
				</extension>
				<created>2021-01-07 04:00:08</created>
				<updated>2021-01-07 13:10:44</updated>
			</invoice>
		</data>
		<status>
			<code>S0885</code>
			<text>The invoices were inquired successfully.</text>
			<type>success</type>
		</status>
	</result>
	<stid>20211125-app3-dev-6348</stid>
</response>
```