• Home
  • Managing Invoices

Enlivy gives you full control over your organization’s invoices via the API.

Whether you’re integrating billing into your own dashboard or automating invoicing workflows, the Enlivy API enables you to list, view, create, and update invoices with precision and ease.

Each invoice in Enlivy is associated with an organization and can include detailed billing information, statuses, and line items.

By using the following endpoints, you can efficiently manage your organization’s invoicing process, connect with internal billing systems, or automate recurring invoice generation.

This section covers the essential operations:

  • List all invoices
  • Retrieve details of a specific invoice
  • Create a new invoice
  • Edit an existing invoice

List All Invoices

Returns a list of invoices for your organization, with support for pagination, filtering, and expanded details like prefixes, tags, line items, and taxes.

bash 
GET /organizations/{organizationId}/invoices

Request Headers

bash 
Authorization: Bearer
Content-Type: application/json

  • page number

    Page number for pagination.

    Default: 1

  • limit number

    Number of invoices per page.

    Default: 20

  • include string

    Comma-separated list of related data to include in the response.

    Examples: invoice_prefix , line_items , taxes , tag_ids

  • include_meta string

    Type of metadata to include alongside the response data.

    Examples: navigation , totals

Example

javascript 
const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

fetch(`https://api.enlivy.com/organizations/${organizationId}/invoices?page=1&limit=20&include=invoice_prefix,tag_ids,line_items,taxes&include_meta=navigation`, {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  }
});

Request Response

This is just a preview, additional fields may appear depending on organization settings.

json 
{
  "data": [
    {
      "id": "dummy_id",
      "organization_id": "dummy_organization_id",
      "organization_bank_account_id": "dummy_bank_account_id",
      "organization_invoice_prefix_id": "dummy_invoice_prefix_id",
      "organization_sender_user_id": "dummy_sender_user_id",
      "organization_receiver_user_id": "dummy_receiver_user_id",
      "number": "1",
      "status": "paid",
      "source": "internal",
      "type": "standard",
      "payment_method": "cash",
      "delivery_method": "email",
      "currency": "RON",
      "sub_total": 99.99,
      "discount": 0,
      "tax_total": 0,
      "total": 99.99,
      "direction": "outbound",
      "tag_ids": [],
      "taxes": {}
    }
  ],
  "meta": {
    "navigation": {
      "active": 18,
      "trash": 3
    },
    "pagination": {
      "total": 18,
      "count": 18,
      "per_page": 20,
      "current_page": 1,
      "total_pages": 1,
      "links": {}
    }
  }
}

Get an Invoice

Retrieve a specific invoice issued or received by your organization, including its full metadata, line items, tax information, direction, and linked entities such as the sending and receiving users.

bash 
GET /organizations/{organizationId}/invoices/{invoiceId}

Request Headers

bash 
Authorization: Bearer
Content-Type: application/json

  • include string

    Comma-separated list of related data to include in the response.

    Examples: invoice_prefix , line_items , taxes , tag_ids

Example

javascript 
const organizationId = "your_org_id";
const invoiceId = "your_invoice_id";
const token = "YOUR_TOKEN_HERE";

fetch(`https://api.enlivy.com/organizations/${organizationId}/invoices/${invoiceId}?include=invoice_prefix,tag_ids,line_items,taxes`, {
  method: 'GET',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  }
});

Request Response

This is just a preview, additional fields may appear depending on organization settings.

json 
{
  "data": {
    "id": "dummy_id",
    "organization_id": "dummy_organization_id",
    "organization_bank_account_id": "dummy_bank_account_id",
    "organization_invoice_prefix_id": "dummy_invoice_prefix_id",
    "organization_sender_user_id": "dummy_sender_user_id",
    "organization_receiver_user_id": "dummy_receiver_user_id",
    "number": "1",
    "status": "paid",
    "source": "internal",
    "type": "standard",
    "payment_method": "cash",
    "delivery_method": "email",
    "currency": "RON",
    "sub_total": 99.99,
    "discount": 0,
    "tax_total": 0,
    "total": 99.99,
    "direction": "outbound",
    "tag_ids": [],
    "taxes": {}
  }
}

Adding an Invoice

Add an issued or received invoice to your organization. Include sender/receiver, currency, dates, payment details, and line items. Supports both internal and external invoices.

bash 
POST /organizations/{organizationId}/invoices

Request Headers

bash 
Authorization: Bearer
Content-Type: application/json

Example

javascript 
const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

fetch(`https://api.enlivy.com/organizations/${organizationId}/invoices`, {
  method: 'POST',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body:      
});

Request Response

This is just a preview, additional fields may appear depending on organization settings.

json 
{
  "id": "org_inv_dummy",
  "organization_id": "org_dummy",
  "organization_bank_account_id": "org_bankacc_dummy",
  "organization_invoice_prefix_id": "org_invpfx_dummy",
  "organization_sender_user_id": "org_user_dummy_sender",
  "organization_receiver_user_id": "org_user_dummy_receiver",
  "number": "1",
  "status": "pending",
  "source": "internal",
  "type": "standard",
  "payment_method": "cash",
  "delivery_method": "email",
  "currency": "RON",
  "sub_total": 99.99,
  "discount": 0,
  "tax_total": 0,
  "total": 99.99,
  "direction": "outbound",
  "issued_at": "2025-05-13T13:00:00Z",
  "invoice_prefix": {
    "data": {}
  },
  "line_items": {
    "data": [
      {
        "id": "org_invli_dummy",
        "organization_id": "org_dummy",
        "organization_invoice_id": "org_inv_dummy",
        "organization_product_id": "org_prod_dummy",
        "order": 1,
        "type": "service",
        "name_lang_map": {
          "ro": "name"
        },
        "unit_lang_map": {
          "ro": "unit"
        },
        "invoice_schema_map": {
          "peppol_billing_unit_code": "H87"
        },
        "quantity": 1,
        "price": 99.99,
        "sub_total": 99.99,
        "discount": 0,
        "tax_total": 0,
        "total": 99.99
      }
    ]
  },
  "tag_ids": [],
  "taxes": {
    "data": []
  }
}

Edit an Invoice

Add an issued or received invoice to your organization. Include sender/receiver, currency, dates, payment details, and line items. Supports both internal and external invoices.

bash 
PUT /organizations/{organizationId}/invoices/{invoiceId}

Example

javascript 
const organizationId = "your_org_id";
const invoiceId = "existing_invoice_id";
const token = "YOUR_TOKEN_HERE";

fetch(`https://api.enlivy.com/organizations/${organizationId}/invoices/${invoiceId}`, {
  method: 'PUT',
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  },
  body:      
});

Request Response

This is just a preview, additional fields may appear depending on organization settings.

json 
{
  "data": {
    "id": "existing_invoice_id",
    "organization_id": "org_dummy",
    "organization_bank_account_id": "org_bankacc_dummy",
    "organization_invoice_prefix_id": "org_invpfx_dummy",
    "organization_sender_user_id": "org_user_dummy_sender",
    "organization_receiver_user_id": "org_user_dummy_receiver",
    "number": "1",
    "status": "paid",
    "source": "internal",
    "type": "standard",
    "payment_method": "bank_transfer",
    "delivery_method": "email",
    "currency": "RON",
    "sub_total": 190.00,
    "discount": 5.00,
    "tax_total": 4.75,
    "total": 189.75,
    "direction": "outbound",
    "issued_at": "2025-05-13T13:00:00Z",
    "line_items": {
      "data": [
        {
          "id": "org_invli_dummy",
          "organization_id": "org_dummy",
          "organization_invoice_id": "org_inv_dummy",
          "organization_product_id": "org_prod_dummy_updated",
          "order": 1,
          "type": "service",
          "name_lang_map": {
            "ro": "name_updated"
          },
          "unit_lang_map": {
            "ro": "unit_updated"
          },
          "invoice_schema_map": {
            "peppol_billing_unit_code": "H88"
          },
          "quantity": 2,
          "price": 95.00,
          "sub_total": 190.00,
          "discount": 5.00,
          "tax_total": 4.75,
          "total": 189.75
        }
      ]
    },
    "tag_ids": [],
    "taxes": {
      "data": []
    }
  }
}