Get All Invoices
Endpoint for getting all Invoices.
info
Please be aware that this endpoint requires a Manage Invoices or a View Invoices API Key.
GET
/api/v1/groups/{group_id}/invoices
Query Parameters
| Name | Description | Type |
|---|---|---|
| partner_name | Search for partner name. | string |
| statuses | Filter the matching statuses. Can be pending, archived, paid or past_due. (Can send multiple, separate them with commas.) | string |
| start | Search for invoices with creation time after start value. | string (YYYY-MM-DDTHH:mm:ssZ) |
| end | Search for invoices with creation time before end value. | string (YYYY-MM-DDTHH:mm:ssZ) |
| limit | Optional parameter to limit the number of results in the query. | uint64 |
| offset | The number of items to skip before starting to collect the result set. | uint64 |
Response
| Code | Description |
|---|---|
| 200 | Success |
| 500 | Internal Error |
Example Usage
- JavaScript
- Python
- Go
get.js
var headers = new Headers();
headers.append('Authorization', 'API_KEY');
var requestOptions = {
method: 'GET',
headers: headers,
redirect: 'follow'
};
const group_id = '';
const url = `https://api.reverepayments.dev/api/v1/groups/${group_id}/invoices`;
fetch(url, requestOptions)
.then((response) => response.text())
.then((result) => console.log(result))
.catch((error) => console.log('error', error));
get.py
import requests
group_id = ""
url = "https://api.reverepayments.dev/api/v1/groups/"+group_id+"/invoices"
headers = {
'Authorization': 'API_KEY'
}
response = requests.request("GET", url, headers=headers)
print(response.text)
get.go
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
const group_id = ""
url := "https://api.reverepayments.dev/api/v1/groups/" + group_id + "/invoices"
client := &http.Client{}
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "API_KEY")
res, _ := client.Do(req)
defer res.Body.Close()
bytes, err := io.ReadAll(res.Body)
if err != nil {
fmt.Println(err.Error())
return
}
fmt.Println(string(bytes))
}
Example Success Response
{
"items": [
{
"id": "7e44c370-078e-4fa3-9909-bdd8554eb068",
"invoice_number": "MY-2025-002-INV",
"group_id": "8059f5c6-e1cd-4e46-9196-1d7e47401a3e",
"slug": "8059f5c6-e1cd-4e46-9196-1d7e47401a3e/MY-2025-002-INV",
"invoice_number_numeric": "002",
"year": "2025",
"note": "Thank you for your purchase!",
"external_id": "48a0f2dc-e7f1-42bb-a237-128990fa69e",
"due_date": "2025-12-18T00:00:00Z",
"send_email": false,
"processor_id": "fbf2e44a-eed6-426f-b0e2-a3a5b34377c0",
"card_enabled": true,
"ach_enabled": true,
"partner": {
"id": "8d7fbc56-b2e1-4e33-8d52-e93bb9a91ab7",
"group_id": "8059f5c6-e1cd-4e46-9196-1d7e47401a3e",
"company": "Dan The Man Co.",
"first_name": "Dan",
"last_name": "Humphrey",
"email": "test@example.com",
"line_1": "E 123 22",
"line_2": "",
"city": "Brooklyn",
"country": "US",
"subdivision": "NY",
"postal_code": "11001",
"created_at": "2025-10-09T10:07:00.597584Z",
"updated_at": "2025-10-09T10:07:00.597584Z"
},
"products": [
{
"id": "0594c1c0-32b2-4d11-866c-29cb5c33f6fc",
"product_id": "4d685310-210f-4a62-924e-88d2bcc97783",
"name": "French fries",
"description": "",
"amount": 500,
"included_tax_amount": 0,
"unit_of_measure": "pc",
"quantity": 4,
"created_at": "2025-11-18T14:27:10.687571Z",
"updated_at": "2025-11-18T14:27:10.687571Z"
},
{
"id": "16340baa-d8d6-4e85-a745-ef95f38dd7dd",
"product_id": "2237b93b-b27a-4d44-a474-78b83446f051",
"name": "Hamburger",
"description": "",
"amount": 1200,
"included_tax_amount": 0,
"unit_of_measure": "pc",
"quantity": 1,
"created_at": "2025-11-18T14:27:10.690051Z",
"updated_at": "2025-11-18T14:27:10.690051Z"
},
{
"id": "5862120f-ea3c-46c2-8deb-aeb2d8ff31e0",
"product_id": "0f3385f6-f522-402c-ad5d-0dc1bd04eb3f",
"name": "Sandwich",
"description": "",
"amount": 1000,
"included_tax_amount": 20,
"unit_of_measure": "pc",
"quantity": 1,
"created_at": "2025-11-18T14:27:10.695221Z",
"updated_at": "2025-11-18T14:27:10.695221Z"
},
{
"id": "60f1dbdd-a17f-426b-9751-b6686f97a8fe",
"product_id": "03e67641-d83a-461e-bfce-660386a6fbbc",
"name": "Tea",
"description": "",
"amount": 300,
"included_tax_amount": 0,
"unit_of_measure": "pc",
"quantity": 5,
"created_at": "2025-11-18T14:27:10.697749Z",
"updated_at": "2025-11-18T14:27:10.697749Z"
},
{
"id": "71169f53-ffae-4457-a0a8-cfdb0910dd58",
"product_id": "3c35ec5c-843d-46a5-aba9-0180b0ad451d",
"name": "Steak",
"description": "",
"amount": 5000,
"included_tax_amount": 200,
"unit_of_measure": "pc",
"quantity": 2,
"created_at": "2025-11-18T14:27:10.684703Z",
"updated_at": "2025-11-18T14:27:10.684703Z"
},
{
"id": "ae0cdb74-9310-40b7-8f86-4917d03ba46d",
"product_id": "e4f73d6e-e132-4d74-97ac-80ff4803c4c3",
"name": "Hot-Dog",
"description": "",
"amount": 700,
"included_tax_amount": 0,
"unit_of_measure": "pc",
"quantity": 1,
"created_at": "2025-11-18T14:27:10.692559Z",
"updated_at": "2025-11-18T14:27:10.692559Z"
}
],
"amount": 16400,
"status": "pending",
"created_at": "2025-11-18T14:27:10.661796Z",
"updated_at": "2025-11-18T14:27:10.661796Z"
},
{
"id": "3dccd93c-fb56-43c7-90df-9c4f96ad988d",
"invoice_number": "MY-2025-001-INV",
"group_id": "8059f5c6-e1cd-4e46-9196-1d7e47401a3e",
"slug": "8059f5c6-e1cd-4e46-9196-1d7e47401a3e/MY-2025-001-INV",
"invoice_number_numeric": "001",
"year": "2025",
"note": "Thank you for your purchase!",
"external_id": "dec29104-1875-4af8-a9db-a1266096ff6",
"due_date": "2025-12-18T00:00:00Z",
"send_email": false,
"processor_id": "fbf2e44a-eed6-426f-b0e2-a3a5b34377c0",
"card_enabled": true,
"ach_enabled": true,
"partner": {
"id": "8d7fbc56-b2e1-4e33-8d52-e93bb9a91ab7",
"group_id": "8059f5c6-e1cd-4e46-9196-1d7e47401a3e",
"company": "Dan The Man Co.",
"first_name": "Dan",
"last_name": "Humphrey",
"email": "test@example.com",
"line_1": "E 123 22",
"line_2": "",
"city": "Brooklyn",
"country": "US",
"subdivision": "NY",
"postal_code": "11001",
"created_at": "2025-10-09T10:07:00.597584Z",
"updated_at": "2025-10-09T10:07:00.597584Z"
},
"products": [
{
"id": "5deec605-95b4-446e-9eb3-8c4171df17c8",
"product_id": "3ad1e74e-3e3b-45ae-be00-82621759c8ec",
"name": "Coffee",
"description": "",
"amount": 500,
"included_tax_amount": 0,
"unit_of_measure": "pc",
"quantity": 3,
"created_at": "2025-11-18T14:11:55.714228Z",
"updated_at": "2025-11-18T14:11:55.714228Z"
},
{
"id": "79fc9894-d916-490b-8333-a81dcfddd70f",
"product_id": "03e67641-d83a-461e-bfce-660386a6fbbc",
"name": "Tea",
"description": "",
"amount": 300,
"included_tax_amount": 0,
"unit_of_measure": "pc",
"quantity": 1,
"created_at": "2025-11-18T14:11:55.711293Z",
"updated_at": "2025-11-18T14:11:55.711293Z"
}
],
"amount": 1800,
"status": "pending",
"created_at": "2025-11-18T14:11:55.69373Z",
"updated_at": "2025-11-18T14:11:55.69373Z"
}
],
"total_count": 2
}