Update a bill

PATCH

bills

{billId}

Update a bill

curl --request PATCH \
  --url https://api.slash.com/v2/bills/{billId} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'x-legal-entity: <x-legal-entity>' \
  --data '
{
  "dueDate": "2026-10-15",
  "lineItems": [
    {
      "id": "bill_line_item_2rj4l7hmrrrcv",
      "name": "Hosting",
      "quantity": 1,
      "unitAmount": {
        "amount": 120000,
        "currency": "USD"
      }
    },
    {
      "name": "Backup storage",
      "quantity": 1,
      "unitAmount": {
        "amount": 4000,
        "currency": "USD"
      }
    }
  ]
}
'

const options = {
  method: 'PATCH',
  headers: {
    'x-legal-entity': '<x-legal-entity>',
    'X-API-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    dueDate: '2026-10-15',
    lineItems: [
      {
        id: 'bill_line_item_2rj4l7hmrrrcv',
        name: 'Hosting',
        quantity: 1,
        unitAmount: {amount: 120000, currency: 'USD'}
      },
      {
        name: 'Backup storage',
        quantity: 1,
        unitAmount: {amount: 4000, currency: 'USD'}
      }
    ]
  })
};

fetch('https://api.slash.com/v2/bills/{billId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/bills/{billId}"

payload = {
    "dueDate": "2026-10-15",
    "lineItems": [
        {
            "id": "bill_line_item_2rj4l7hmrrrcv",
            "name": "Hosting",
            "quantity": 1,
            "unitAmount": {
                "amount": 120000,
                "currency": "USD"
            }
        },
        {
            "name": "Backup storage",
            "quantity": 1,
            "unitAmount": {
                "amount": 4000,
                "currency": "USD"
            }
        }
    ]
}
headers = {
    "x-legal-entity": "<x-legal-entity>",
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slash.com/v2/bills/{billId}"

	payload := strings.NewReader("{\n  \"dueDate\": \"2026-10-15\",\n  \"lineItems\": [\n    {\n      \"id\": \"bill_line_item_2rj4l7hmrrrcv\",\n      \"name\": \"Hosting\",\n      \"quantity\": 1,\n      \"unitAmount\": {\n        \"amount\": 120000,\n        \"currency\": \"USD\"\n      }\n    },\n    {\n      \"name\": \"Backup storage\",\n      \"quantity\": 1,\n      \"unitAmount\": {\n        \"amount\": 4000,\n        \"currency\": \"USD\"\n      }\n    }\n  ]\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-legal-entity", "<x-legal-entity>")
	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "bill_2rj4l7hmrrrcv",
  "status": "draft",
  "source": "manual",
  "currency": "USD",
  "amounts": {
    "total": {
      "amount": 123,
      "currency": "<string>"
    },
    "tax": {
      "amount": 123,
      "currency": "<string>"
    },
    "discount": {
      "amount": 123,
      "currency": "<string>"
    },
    "outstanding": {
      "amount": 123,
      "currency": "<string>"
    }
  },
  "lineItems": [
    {
      "id": "bill_line_item_2rj4l7hmrrrcv",
      "name": "Hosting",
      "quantity": 1,
      "unitAmount": {
        "amount": 123,
        "currency": "<string>"
      },
      "total": {
        "amount": 123,
        "currency": "<string>"
      }
    }
  ],
  "documentIds": [
    "st_2rj4l7hmrrrcv"
  ],
  "payments": [
    {
      "id": "bill_payment_2rj4l7hmrrrcv",
      "status": "pending",
      "detailedStatus": "pending",
      "amount": {
        "amount": 123,
        "currency": "<string>"
      },
      "createdAt": "2023-11-07T05:31:56Z",
      "transferId": "transfer_intent_2rj4l7hmrrrcv",
      "transactionId": "agg_tx_2rj4l7hmrrrcv"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "vendorContactId": "le_c_2rj4l7hmrrrcv",
  "destinationId": "le_contact_destination_2rj4l7hmrrrcv",
  "ownerUserId": "u_2rj4l7hmrrrcv",
  "invoiceNumber": "INV-4471",
  "invoiceDate": "2026-09-01",
  "dueDate": "2026-10-01",
  "notes": "<string>"
}

Authorizations

X-API-Key

string

header

required

User API key authentication. Create a key under Settings → API keys in the Slash dashboard (https://app.slash.com/global-settings/api-keys) and send the x-legal-entity header naming the legal entity to act on with every request. Keys scoped to a legal entity are rejected with 403 user_api_key_required.

Headers

x-legal-entity

string

required

The legal entity to act on. Required on every request; a user API key can act on any legal entity its user has access to.

Pattern: ^le_[a-zA-Z0-9]+$

Path Parameters

billId

string

required

Bill id with the bill_ prefix.

Body

application/json

Partial update. An omitted field is left unchanged; null clears a clearable field. lineItems, tax, and discount are financial fields and are rejected with bill_amounts_locked once the bill has a payment that is not canceled or rejected.

vendorContactId

string | null

The vendor contact. null clears it. Changing the vendor also clears destinationId unless you send one or the current destination belongs to the new vendor.

Example:

"le_c_2rj4l7hmrrrcv"

destinationId

string | null

The destination the bill should be paid to. null clears it.

Example:

"le_contact_destination_2rj4l7hmrrrcv"

ownerUserId

string

The user responsible for the bill.

Example:

"u_2rj4l7hmrrrcv"

invoiceNumber

string | null

The vendor's invoice number. null clears it.

Maximum string length: 255

invoiceDate

string<date> | null

Invoice date as YYYY-MM-DD. null clears it.

dueDate

string<date> | null

Due date as YYYY-MM-DD. null clears it.

lineItems

BillLineItemUpdate · object[]

Replaces the line items. Lines sent with an id are updated in place; lines without one are appended; existing lines whose ids are omitted are removed.

Minimum array length: 1

Hide child attributes

lineItems.name

string

required

What the line is for.

Required string length: 1 - 255

Example:

"Hosting"

lineItems.quantity

number

required

Number of units greater than zero. Fractional quantities are allowed.

Example:

1

lineItems.unitAmount

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

lineItems.unitAmount.amount

integer

required

Amount in the currency's minor units.

lineItems.unitAmount.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

lineItems.id

string

The id of an existing line to change in place. Lines whose ids are omitted from the array are removed.

Example:

"bill_line_item_2rj4l7hmrrrcv"

tax

object

Tax added to the line totals, in the bill's currency.

Hide child attributes

tax.amount

integer

required

Amount in the currency's minor units.

Required range: x >= 0

Example:

800

tax.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

Example:

"USD"

discount

object

Discount taken off the line totals, in the bill's currency.

Hide child attributes

discount.amount

integer

required

Amount in the currency's minor units.

Required range: x >= 0

Example:

500

discount.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

Example:

"USD"

notes

string | null

Free-text notes. null clears them.

Maximum string length: 5000

Response

The updated bill.

Money your legal entity owes a vendor. status and amounts.outstanding are derived from the bill's payments and cannot be set directly.

string

required

Bill id with the bill_ prefix.

Example:

"bill_2rj4l7hmrrrcv"

status

enum<string>

required

Derived from the bill's payments. draft until a payment exists; pending_approval while a payment awaits approval; rejected when the latest approval was rejected; scheduled when a payment is scheduled; payment_pending while a payment is in flight; partially_paid when settled payments cover part of the total; paid when they cover all of it; payment_failed when the latest payment failed or was returned.

Available options:

draft,

pending_approval,

rejected,

scheduled,

payment_pending,

paid,

payment_failed,

partially_paid

source

enum<string>

required

How the bill entered Slash. api for bills created through this API, manual for the dashboard, email for the accounts-payable inbox, carrier_account for bills pulled from a connected carrier portal. Carrier bills are read-only over the API.

Available options:

manual,

email,

carrier_account,

api

currency

string

required

Uppercase ISO 4217 currency code shared by every amount on the bill.

Pattern: ^[A-Z]{3}$

Example:

"USD"

amounts

object

required

Every amount is in currency, in minor units.

Hide child attributes

amounts.total

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

amounts.total.amount

integer

required

Amount in the currency's minor units.

amounts.total.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

amounts.tax

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

amounts.tax.amount

integer

required

Amount in the currency's minor units.

amounts.tax.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

amounts.discount

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

amounts.discount.amount

integer

required

Amount in the currency's minor units.

amounts.discount.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

amounts.outstanding

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

amounts.outstanding.amount

integer

required

Amount in the currency's minor units.

amounts.outstanding.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

lineItems

BillLineItem · object[]

required

Line items in display order.

Hide child attributes

lineItems.id

string

required

Line item id with the bill_line_item_ prefix.

Example:

"bill_line_item_2rj4l7hmrrrcv"

lineItems.name

string

required

What the line is for, as printed on the invoice.

Example:

"Hosting"

lineItems.quantity

number

required

Number of units. Fractional quantities are allowed.

Example:

1

lineItems.unitAmount

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

lineItems.unitAmount.amount

integer

required

Amount in the currency's minor units.

lineItems.unitAmount.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

lineItems.total

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

lineItems.total.amount

integer

required

Amount in the currency's minor units.

lineItems.total.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

documentIds

string[]

required

Documents attached to the bill, readable at GET /v2/documents/{documentId}.

payments

BillPayment · object[]

required

Payments linked to the bill, oldest first.

Hide child attributes

payments.id

string

required

Payment link id with the bill_payment_ prefix. Unlink the payment with DELETE /v2/bills/{billId}/payments/{paymentId}.

Example:

"bill_payment_2rj4l7hmrrrcv"

payments.status

enum<string>

required

Coarse transaction state.

Available options:

pending,

posted,

failed

payments.detailedStatus

enum<string>

required

Exact transaction lifecycle state across every category.

Available options:

pending,

pending_destination,

pending_approval,

in_review,

scheduled,

canceled,

failed,

settled,

declined,

refund,

reversed,

returned,

dispute

payments.amount

Money · object

required

A signed monetary amount expressed in minor units.

Hide child attributes

payments.amount.amount

integer

required

Amount in the currency's minor units.

payments.amount.currency

string

required

Uppercase ISO 4217 currency code.

Pattern: ^[A-Z]{3}$

payments.createdAt

string<date-time>

required

When the payment was linked to the bill.

payments.transferId

string

Id of the transfer that pays the bill, with the transfer_intent_ prefix, readable at GET /v2/transfers/{transferId}. Absent for payments that are not yet a transfer (a scheduled payment whose transfer has not been constructed) or that were made outside the transfer rails.

Example:

"transfer_intent_2rj4l7hmrrrcv"

payments.transactionId

string

Id of the transaction that moved the money, with the agg_tx_ prefix, readable at GET /v2/transactions/{transactionId}. For a card purchase it's the card transaction. Absent when the payment's only transactions are ones the transactions API doesn't return, such as a rejected or canceled approval request.

Example:

"agg_tx_2rj4l7hmrrrcv"

createdAt

string<date-time>

required

When the bill was created.

vendorContactId

string

The vendor contact, readable at GET /v2/contacts/{contactId}.

Example:

"le_c_2rj4l7hmrrrcv"

destinationId

string

The destination the bill is expected to be paid to, readable at GET /v2/destinations/{destinationId}.

Example:

"le_contact_destination_2rj4l7hmrrrcv"

ownerUserId

string

The user responsible for the bill. Absent for bills that arrived by email and have not been assigned.

Example:

"u_2rj4l7hmrrrcv"

invoiceNumber

string

The vendor's invoice number.

Example:

"INV-4471"

invoiceDate

string<date>

Invoice date as YYYY-MM-DD.

Example:

"2026-09-01"

dueDate

string<date>

Due date as YYYY-MM-DD.

Example:

"2026-10-01"

notes

string

Free-text notes visible to your organization.

⌘I

Update a bill

curl --request PATCH \
  --url https://api.slash.com/v2/bills/{billId} \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'x-legal-entity: <x-legal-entity>' \
  --data '
{
  "dueDate": "2026-10-15",
  "lineItems": [
    {
      "id": "bill_line_item_2rj4l7hmrrrcv",
      "name": "Hosting",
      "quantity": 1,
      "unitAmount": {
        "amount": 120000,
        "currency": "USD"
      }
    },
    {
      "name": "Backup storage",
      "quantity": 1,
      "unitAmount": {
        "amount": 4000,
        "currency": "USD"
      }
    }
  ]
}
'

const options = {
  method: 'PATCH',
  headers: {
    'x-legal-entity': '<x-legal-entity>',
    'X-API-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    dueDate: '2026-10-15',
    lineItems: [
      {
        id: 'bill_line_item_2rj4l7hmrrrcv',
        name: 'Hosting',
        quantity: 1,
        unitAmount: {amount: 120000, currency: 'USD'}
      },
      {
        name: 'Backup storage',
        quantity: 1,
        unitAmount: {amount: 4000, currency: 'USD'}
      }
    ]
  })
};

fetch('https://api.slash.com/v2/bills/{billId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.slash.com/v2/bills/{billId}"

payload = {
    "dueDate": "2026-10-15",
    "lineItems": [
        {
            "id": "bill_line_item_2rj4l7hmrrrcv",
            "name": "Hosting",
            "quantity": 1,
            "unitAmount": {
                "amount": 120000,
                "currency": "USD"
            }
        },
        {
            "name": "Backup storage",
            "quantity": 1,
            "unitAmount": {
                "amount": 4000,
                "currency": "USD"
            }
        }
    ]
}
headers = {
    "x-legal-entity": "<x-legal-entity>",
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.slash.com/v2/bills/{billId}"

	payload := strings.NewReader("{\n  \"dueDate\": \"2026-10-15\",\n  \"lineItems\": [\n    {\n      \"id\": \"bill_line_item_2rj4l7hmrrrcv\",\n      \"name\": \"Hosting\",\n      \"quantity\": 1,\n      \"unitAmount\": {\n        \"amount\": 120000,\n        \"currency\": \"USD\"\n      }\n    },\n    {\n      \"name\": \"Backup storage\",\n      \"quantity\": 1,\n      \"unitAmount\": {\n        \"amount\": 4000,\n        \"currency\": \"USD\"\n      }\n    }\n  ]\n}")

	req, _ := http.NewRequest("PATCH", url, payload)

	req.Header.Add("x-legal-entity", "<x-legal-entity>")
	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "id": "bill_2rj4l7hmrrrcv",
  "status": "draft",
  "source": "manual",
  "currency": "USD",
  "amounts": {
    "total": {
      "amount": 123,
      "currency": "<string>"
    },
    "tax": {
      "amount": 123,
      "currency": "<string>"
    },
    "discount": {
      "amount": 123,
      "currency": "<string>"
    },
    "outstanding": {
      "amount": 123,
      "currency": "<string>"
    }
  },
  "lineItems": [
    {
      "id": "bill_line_item_2rj4l7hmrrrcv",
      "name": "Hosting",
      "quantity": 1,
      "unitAmount": {
        "amount": 123,
        "currency": "<string>"
      },
      "total": {
        "amount": 123,
        "currency": "<string>"
      }
    }
  ],
  "documentIds": [
    "st_2rj4l7hmrrrcv"
  ],
  "payments": [
    {
      "id": "bill_payment_2rj4l7hmrrrcv",
      "status": "pending",
      "detailedStatus": "pending",
      "amount": {
        "amount": 123,
        "currency": "<string>"
      },
      "createdAt": "2023-11-07T05:31:56Z",
      "transferId": "transfer_intent_2rj4l7hmrrrcv",
      "transactionId": "agg_tx_2rj4l7hmrrrcv"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "vendorContactId": "le_c_2rj4l7hmrrrcv",
  "destinationId": "le_contact_destination_2rj4l7hmrrrcv",
  "ownerUserId": "u_2rj4l7hmrrrcv",
  "invoiceNumber": "INV-4471",
  "invoiceDate": "2026-09-01",
  "dueDate": "2026-10-01",
  "notes": "<string>"
}

Accounts

Virtual accounts

Contacts

Transfers

Transactions

Documents

Bills

Accounting

Update a bill

Authorizations

Headers

Path Parameters

Body

Response