Skip to main content
GET
/
api
/
v1
/
invoices
curl -X GET "https://app.monk.com/api/v1/invoices?status=Paid&limit=10" \
  -H "Authorization: Bearer mk_live_your_api_key"

{
  "data": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "invoiceNumber": "INV-2024-001",
      "customerId": "550e8400-e29b-41d4-a716-446655440000",
      "contractId": "770e8400-e29b-41d4-a716-446655440002",
      "status": "Paid",
      "invoiceDate": "2024-01-15",
      "dueDate": "2024-02-15",
      "totalCents": 150000,
      "memo": "January services",
      "createdAt": "2024-01-01T00:00:00.000Z",
      "updatedAt": "2024-01-20T00:00:00.000Z"
    }
  ],
  "hasMore": false,
  "total": 1
}

​
Authentication

​
Authorization
string
required
Bearer token with your API key. Example: Bearer mk_live_...
Required scope: invoices:read

​
Query Parameters

​
customerId
string
Filter invoices by customer ID
​
status
string
Filter by invoice status. Valid values: Drafted, In Progress, In Transit, Paid, Cancelled, Refunded
​
createdAfter
string
Filter invoices created after this ISO 8601 date
​
createdBefore
string
Filter invoices created before this ISO 8601 date
​
limit
integer
default:"10"
Maximum number of invoices to return. Max: 100
​
offset
integer
default:"0"
Number of invoices to skip for pagination

​
Response

​
data
array
Array of invoice objects
​
hasMore
boolean
Whether more results exist beyond the current page
​
total
integer
Total count of invoices matching the query
curl -X GET "https://app.monk.com/api/v1/invoices?status=Paid&limit=10" \
  -H "Authorization: Bearer mk_live_your_api_key"

{
  "data": [
    {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "invoiceNumber": "INV-2024-001",
      "customerId": "550e8400-e29b-41d4-a716-446655440000",
      "contractId": "770e8400-e29b-41d4-a716-446655440002",
      "status": "Paid",
      "invoiceDate": "2024-01-15",
      "dueDate": "2024-02-15",
      "totalCents": 150000,
      "memo": "January services",
      "createdAt": "2024-01-01T00:00:00.000Z",
      "updatedAt": "2024-01-20T00:00:00.000Z"
    }
  ],
  "hasMore": false,
  "total": 1
}