API Documentation

Time Tracking

Extended REST API
Clients
Projects
Tasks
People
Expenses
Expense Tracking
User Assignment
Task Assignment
Reports
Invoices
Invoice Messages
Invoice Payments
Invoice Categories


Questions?
Email support@getharvest.com

Invoice Messages

Important: this assumes invoice feature is enabled for your account.

Invoice messages are notes displayed in the activity log section of an invoice.

Show all messages sent for an invoice

GET /invoice/#{invoice_id}/messages

HTTP Response: 200 Success 
<?xml version="1.0" encoding="UTF-8"?>
<invoice-messages type="array">
  <invoice-message>
    <body>The message body goes here</body>
    <created-at type="datetime">2008-04-09T20:44:54Z</created-at>
    <id type="integer">409</id>
    <invoice-id type="integer">1420</invoice-id>
    <send-me-a-copy type="boolean">true</send-me-a-copy>
    <sent-by>My Name</sent-by>
    <sent-by-email>my@email.com</sent-by-email>
    <!-- comma separated list of recipient email addresses using the
         "Name <emai@domain.com>" format -->
    <full-recipient-list>Jane Doe &lt;jane@doe.org&gt;,
     My Name &lt;my@email.com&gt;</full-recipient-list>
  </invoice-message>
  <!-- ... -->
</invoice-messages>
Show a particular message

GET /invoice/#{invoice_id}/messages/#{message_id}

HTTP Response: 200 Success 
<?xml version="1.0" encoding="UTF-8"?>
<invoice-message>
  <body>Anther message body goes here</body>
  <created-at type="datetime">2008-04-09T20:46:34Z</created-at>
  <id type="integer">403</id>
  <invoice-id type="integer">1420</invoice-id>
  <send-me-a-copy type="boolean">true</send-me-a-copy>
  <sent-by>My Name</sent-by>
  <sent-by-email>my@email.com</sent-by-email>
  <full-recipient-list>Jane Doe &lt;jane@doe.org&gt;,
   My Name &lt;my@email.com&gt;</full-recipient-list>
</invoice-message>
Delete existing message

DELETE /invoice/#{invoice_id}/messages/#{message_id}

HTTP Response: 200 OK.