GET
/api/v1/invoicesRetrieve a list of invoices
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
limit | integer | Optional | Number of results (max 100)(default: 50) |
offset | integer | Optional | Pagination offset(default: 0) |
status | string | Optional | Filter by status: pending, paid, overdue |
vendor | string | Optional | Filter by vendor name |
startDate | string | Optional | Filter from date (YYYY-MM-DD) |
endDate | string | Optional | Filter to date (YYYY-MM-DD) |
Response
{
"invoices": [
{
"id": "inv_123abc",
"vendor": "AWS",
"amount": 245.50,
"currency": "USD",
"invoiceNumber": "INV-2026-001",
"invoiceDate": "2026-02-15",
"dueDate": "2026-03-15",
"status": "pending",
"tags": ["hosting", "infrastructure"],
"emailId": "msg_456def",
"attachmentUrl": "https://...",
"createdAt": "2026-02-15T10:30:00Z",
"updatedAt": "2026-02-15T10:30:00Z"
}
],
"total": 150,
"limit": 50,
"offset": 0
}Example Request
curl -X GET https://api.invoicesorter.app/v1/api/v1/invoices \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json"