Get All Invoices

Retrieve a list of all invoices.

Endpoint

GET /api/invoices

Request

GET https://app.getmanageit.io/api/invoices
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Response

{
  "data": [
    {
      "id": 1,
      "invoice_number": "INV-001",
      "customer_id": 123,
      "customer_name": "John Doe",
      "customer_email": "[email protected]",
      "status": "draft",
      "total_amount": 1500.00,
      "currency": "USD",
      "due_date": "2024-02-15",
      "created_at": "2024-01-15T10:30:00Z",
      "updated_at": "2024-01-15T10:30:00Z",
      "line_items": [
        {
          "id": 1,
          "description": "Web Development Services",
          "quantity": 10,
          "unit_price": 100.00,
          "total": 1000.00
        },
        {
          "id": 2,
          "description": "Design Services",
          "quantity": 5,
          "unit_price": 100.00,
          "total": 500.00
        }
      ]
    },
    {
      "id": 2,
      "invoice_number": "INV-002",
      "customer_id": 124,
      "customer_name": "Jane Smith",
      "customer_email": "[email protected]",
      "status": "sent",
      "total_amount": 2750.50,
      "currency": "USD",
      "due_date": "2024-02-20",
      "created_at": "2024-01-16T14:22:00Z",
      "updated_at": "2024-01-16T14:22:00Z",
      "line_items": [
        {
          "id": 3,
          "description": "Consulting Services",
          "quantity": 20,
          "unit_price": 125.00,
          "total": 2500.00
        },
        {
          "id": 4,
          "description": "Setup Fee",
          "quantity": 1,
          "unit_price": 250.50,
          "total": 250.50
        }
      ]
    },
    {
      "id": 3,
      "invoice_number": "INV-003",
      "customer_id": 125,
      "customer_name": "Acme Corp",
      "customer_email": "[email protected]",
      "status": "paid",
      "total_amount": 5000.00,
      "currency": "USD",
      "due_date": "2024-01-30",
      "created_at": "2024-01-10T09:15:00Z",
      "updated_at": "2024-01-25T16:45:00Z",
      "line_items": [
        {
          "id": 5,
          "description": "Enterprise License",
          "quantity": 1,
          "unit_price": 5000.00,
          "total": 5000.00
        }
      ]
    }
  ],
  "meta": {
    "total": 3,
    "page": 1,
    "limit": 10
  },
  "timestamp": "2024-01-15T10:30:00Z"
}

Response Fields

Field	Type	Description
id	integer	Unique identifier for the invoice
invoice_number	string	Human-readable invoice number
customer_id	integer	ID of the associated customer
customer_name	string	Name of the customer
customer_email	string	Email address of the customer
status	string	Current status of the invoice (draft, sent, paid, overdue)
total_amount	decimal	Total amount of the invoice
currency	string	Currency code (e.g., USD, EUR)
due_date	date	Date when the invoice is due
created_at	datetime	When the invoice was created
updated_at	datetime	When the invoice was last updated
line_items	array	Array of line items for the invoice

Line Item Fields

Field	Type	Description
id	integer	Unique identifier for the line item
description	string	Description of the service/product
quantity	decimal	Quantity of the item
unit_price	decimal	Price per unit
total	decimal	Total price for this line item

Status Codes

Code	Description
200	Success
401	Unauthorized
500	Server Error

---