InvoiceXpress API (2.0.0)

Copy

• Copy for LLM

  Copy page as Markdown for LLMs
• View as Markdown

  Open this page as Markdown
• Open in ChatGPT

  Get insights from ChatGPT
• Open in Claude

  Get insights from Claude
• Connect to Cursor

  Install MCP server on Cursor
• Connect to VS Code

  Install MCP server on VS Code

curl -i -X GET \
  'https://your-account.app.invoicexpress.com/invoices.json?api_key=YOUR_API_KEY%2CYOUR_API_KEY_HERE&type%5B%5D=Invoice&status%5B%5D=sent&non_archived=true&archived=true&text=string&reference=string&date%5Bfrom%5D=string&date%5Bto%5D=string&due_date%5Bfrom%5D=string&due_date%5Bto%5D=string&total_before_taxes%5Bfrom%5D=0&total_before_taxes%5Bto%5D=0&page=0&per_page=0'

curl -i -X POST \
  'https://your-account.app.invoicexpress.com/{invoices-type}.json?api_key=YOUR_API_KEY%2CYOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "invoice": {
      "date": "22/11/2025",
      "due_date": "22/12/2025",
      "reference": "PO-999",
      "observations": "Services rendered",
      "retention": "0",
      "tax_exemption": "M00",
      "sequence_id": "123456",
      "manual_sequence_number": "string",
      "client": {
        "name": "Client A",
        "code": "CLI-001",
        "email": "client@mail.com",
        "address": "Street A",
        "city": "Lisbon",
        "postal_code": "1000-100",
        "fiscal_id": "500999888",
        "country": "Portugal",
        "website": "www.client-a.com",
        "phone": "912345678",
        "fax": "212345678",
        "observations": "VIP Client"
      },
      "items": [
        {
          "name": "Consulting",
          "description": "IT Services",
          "unit_price": 50,
          "quantity": 2,
          "unit": "hour",
          "discount": 0,
          "tax": {
            "name": "IVA23"
          }
        }
      ],
      "mb_reference": "1",
      "owner_invoice_id": 1049,
      "tax_exemption_reason": "M00",
      "currency_code": "USD",
      "rate": "1.10",
      "plugin_id": "plugin_123",
      "global_discount": {
        "value_type": "percentage",
        "value": 10
      }
    },
    "proprietary_uid": "uuid-123"
  }'

curl -i -X GET \
  'https://your-account.app.invoicexpress.com/{invoices-type}/1050.json?api_key=YOUR_API_KEY%2CYOUR_API_KEY_HERE'

curl -i -X PUT \
  'https://your-account.app.invoicexpress.com/{invoices-type}/1050.json?api_key=YOUR_API_KEY%2CYOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "invoice": {
      "date": "22/11/2025",
      "due_date": "22/12/2025",
      "reference": "PO-999",
      "observations": "Services rendered",
      "retention": "0",
      "tax_exemption": "M00",
      "sequence_id": "123456",
      "manual_sequence_number": "string",
      "client": {
        "name": "Client A",
        "code": "CLI-001",
        "email": "client@mail.com",
        "address": "Street A",
        "city": "Lisbon",
        "postal_code": "1000-100",
        "fiscal_id": "500999888",
        "country": "Portugal",
        "website": "www.client-a.com",
        "phone": "912345678",
        "fax": "212345678",
        "observations": "VIP Client"
      },
      "items": [
        {
          "name": "Consulting",
          "description": "IT Services",
          "unit_price": 50,
          "quantity": 2,
          "unit": "hour",
          "discount": 0,
          "tax": {
            "name": "IVA23"
          }
        }
      ],
      "mb_reference": "1",
      "owner_invoice_id": 1049,
      "tax_exemption_reason": "M00",
      "currency_code": "USD",
      "rate": "1.10",
      "plugin_id": "plugin_123",
      "global_discount": {
        "value_type": "percentage",
        "value": 10
      }
    }
  }'

curl -i -X PUT \
  'https://your-account.app.invoicexpress.com/{invoices-type}/1050/change-state.json?api_key=YOUR_API_KEY%2CYOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "invoice": {
      "state": "finalized",
      "message": "Wrong value"
    }
  }'

curl -i -X PUT \
  'https://your-account.app.invoicexpress.com/{invoices-type}/1050/email-document.json?api_key=YOUR_API_KEY%2CYOUR_API_KEY_HERE' \
  -H 'Content-Type: application/json' \
  -d '{
    "message": {
      "client": {
        "email": "dest@mail.com",
        "save": "1"
      },
      "subject": "Invoice",
      "body": "Attached.",
      "cc": "cc@mail.com",
      "bcc": "bcc@mail.com",
      "logo": "1"
    }
  }'