Create an invoice

POST

invoices

Create an invoice

curl --request POST \
  --url https://api.slash.com/v2/invoices \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --header 'x-legal-entity: <x-legal-entity>' \
  --data '
{
  "customerId": "le_cus_2rj4l7hmrrrcv",
  "issueDate": "2026-10-01",
  "dueDate": "2026-10-31",
  "timezone": "America/New_York",
  "lineItems": [
    {
      "name": "Design retainer",
      "quantity": 1,
      "unitAmount": {
        "amount": 450000,
        "currency": "USD"
      }
    },
    {
      "name": "Extra hours",
      "quantity": 6,
      "unitAmount": {
        "amount": 15000,
        "currency": "USD"
      }
    }
  ],
  "taxRate": 8.5,
  "paymentMethods": [
    {
      "type": "bank_transfer"
    },
    {
      "type": "card",
      "passFeeToPayer": true
    }
  ]
}
'

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency-Key': '<x-idempotency-key>',
    'x-legal-entity': '<x-legal-entity>',
    'X-API-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    customerId: 'le_cus_2rj4l7hmrrrcv',
    issueDate: '2026-10-01',
    dueDate: '2026-10-31',
    timezone: 'America/New_York',
    lineItems: [
      {
        name: 'Design retainer',
        quantity: 1,
        unitAmount: {amount: 450000, currency: 'USD'}
      },
      {name: 'Extra hours', quantity: 6, unitAmount: {amount: 15000, currency: 'USD'}}
    ],
    taxRate: 8.5,
    paymentMethods: [{type: 'bank_transfer'}, {type: 'card', passFeeToPayer: true}]
  })
};

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

import requests

url = "https://api.slash.com/v2/invoices"

payload = {
    "customerId": "le_cus_2rj4l7hmrrrcv",
    "issueDate": "2026-10-01",
    "dueDate": "2026-10-31",
    "timezone": "America/New_York",
    "lineItems": [
        {
            "name": "Design retainer",
            "quantity": 1,
            "unitAmount": {
                "amount": 450000,
                "currency": "USD"
            }
        },
        {
            "name": "Extra hours",
            "quantity": 6,
            "unitAmount": {
                "amount": 15000,
                "currency": "USD"
            }
        }
    ],
    "taxRate": 8.5,
    "paymentMethods": [
        { "type": "bank_transfer" },
        {
            "type": "card",
            "passFeeToPayer": True
        }
    ]
}
headers = {
    "X-Idempotency-Key": "<x-idempotency-key>",
    "x-legal-entity": "<x-legal-entity>",
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

package main

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

func main() {

	url := "https://api.slash.com/v2/invoices"

	payload := strings.NewReader("{\n  \"customerId\": \"le_cus_2rj4l7hmrrrcv\",\n  \"issueDate\": \"2026-10-01\",\n  \"dueDate\": \"2026-10-31\",\n  \"timezone\": \"America/New_York\",\n  \"lineItems\": [\n    {\n      \"name\": \"Design retainer\",\n      \"quantity\": 1,\n      \"unitAmount\": {\n        \"amount\": 450000,\n        \"currency\": \"USD\"\n      }\n    },\n    {\n      \"name\": \"Extra hours\",\n      \"quantity\": 6,\n      \"unitAmount\": {\n        \"amount\": 15000,\n        \"currency\": \"USD\"\n      }\n    }\n  ],\n  \"taxRate\": 8.5,\n  \"paymentMethods\": [\n    {\n      \"type\": \"bank_transfer\"\n    },\n    {\n      \"type\": \"card\",\n      \"passFeeToPayer\": true\n    }\n  ]\n}")

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

	req.Header.Add("X-Idempotency-Key", "<x-idempotency-key>")
	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": "inv_2rj4l7hmrrrcv",
  "number": "INV-1042",
  "status": "scheduled",
  "overdue": true,
  "accountId": "sa_group_2rj4l7hmrrrcv",
  "issueDate": "2023-12-25",
  "dueDate": "2023-12-25",
  "timezone": "America/New_York",
  "lineItems": [
    {
      "name": "Robot arm maintenance",
      "quantity": 2,
      "unitAmount": {
        "amount": 123,
        "currency": "<string>"
      },
      "total": {
        "amount": 123,
        "currency": "<string>"
      },
      "catalogItemId": "<string>"
    }
  ],
  "amounts": {
    "subtotal": {
      "amount": 123,
      "currency": "<string>"
    },
    "discount": {
      "amount": 123,
      "currency": "<string>"
    },
    "tax": {
      "amount": 123,
      "currency": "<string>"
    },
    "total": {
      "amount": 123,
      "currency": "<string>"
    },
    "paid": {
      "amount": 123,
      "currency": "<string>"
    },
    "outstanding": {
      "amount": 123,
      "currency": "<string>"
    }
  },
  "ccEmails": [
    "<string>"
  ],
  "billedTo": {
    "name": "<string>",
    "email": "<string>",
    "address": {
      "line1": "<string>",
      "city": "<string>",
      "line2": "<string>",
      "state": "<string>",
      "postalCode": "<string>",
      "countryCode": "<string>"
    }
  },
  "paymentMethods": [
    {
      "type": "bank_transfer",
      "passFeeToPayer": true
    }
  ],
  "payments": [
    {
      "id": "inv_tr_link_2rj4l7hmrrrcv",
      "amount": {
        "amount": 123,
        "currency": "<string>"
      },
      "paidOn": "2023-12-25",
      "method": "ach",
      "matchedBy": "automatic",
      "createdAt": "2023-11-07T05:31:56Z",
      "transactionId": "agg_tx_2rj4l7hmrrrcv"
    }
  ],
  "payUrl": "<string>",
  "documentId": "st_2rj4l7hmrrrcv",
  "createdAt": "2023-11-07T05:31:56Z",
  "customerId": "le_cus_2rj4l7hmrrrcv",
  "virtualAccountId": "<string>",
  "seriesId": "<string>",
  "scheduledSendDate": "2023-12-25",
  "discount": {
    "type": "percentage",
    "percent": 10
  },
  "taxRate": 8.5,
  "memo": "<string>",
  "nextReminderAt": "2023-11-07T05:31:56Z",
  "paidAt": "2023-11-07T05:31:56Z",
  "voidedAt": "2023-11-07T05:31:56Z"
}

See Create an invoice.

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-Idempotency-Key

string

required

Unique caller-generated key for one create request. Once an authenticated, schema-valid request reaches the operation, the key is permanently consumed for that operation and legal entity whether the operation succeeds or fails. Reusing it in that scope returns 409 and never replays a response, unlike API v1, which replays the original response for a matching key.

Required string length: 1 - 255

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]+$

Body

application/json

customerId

string

required

Customer id with the le_cus_ prefix.

issueDate

string<date>

required

dueDate

string<date>

required

On or after issueDate.

timezone

string

required

The IANA timezone the invoice's dates are in.

Minimum string length: 1

Example:

"America/New_York"

lineItems

InvoiceLineItemCreate · object[]

required

Required array length: 1 - 200 elements

Hide child attributes

lineItems.name

string

required

Required string length: 1 - 255

Example:

"Robot arm maintenance"

lineItems.quantity

number

required

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

Example:

2

lineItems.unitAmount

object

required

Price per unit in USD cents.

Hide child attributes

lineItems.unitAmount.amount

integer

required

Required range: x >= 0

Example:

45000

lineItems.unitAmount.currency

enum<string>

required

Available options:

USD

lineItems.catalogItemId

string

The catalog item this line comes from, with the cat_item_ prefix. Send the item's name and unitAmount too; the line keeps what you send.

accountId

string

The account payments settle into, with the sa_group_ prefix. Required when the legal entity has more than one account that can receive payments.

virtualAccountId

string

A virtual account to settle into instead of the account's primary one, with the subaccount_ prefix.

number

string

Uppercase letters, digits, dashes and underscores. Defaults to the next number in your invoice settings.

Required string length: 1 - 50

Pattern: ^[A-Z0-9_-]+$

Example:

"INV-1042"

scheduledSendDate

string<date>

Email the invoice at 9:00 on this day in timezone instead of now. The invoice stays scheduled until then.

discount

Percentage · object

Taken off the line items' subtotal before tax.

Percentage
Fixed

Hide child attributes

discount.type

enum<string>

required

Available options:

percentage

discount.percent

number

required

Percent of the subtotal. 10 means 10%.

Required range: x <= 100

Example:

10

taxRate

number

Tax as a percent of the subtotal after the discount. 8.5 means 8.5%.

Required range: 0 <= x <= 100

memo

string

A note printed on the invoice.

Required string length: 1 - 500

ccEmails

string<email>[]

Also copied on the invoice and its reminders.

Maximum array length: 10

paymentMethods

InvoicePaymentMethodInput · object[]

How the customer can pay, each type at most once. bank_transfer is always offered, so omit this to offer only that.

Maximum array length: 4

Hide child attributes

paymentMethods.type

enum<string>

required

Available options:

bank_transfer,

ach_debit,

card,

crypto

paymentMethods.passFeeToPayer

boolean

Whether the payer covers the processing fee. Defaults to false; ignored for bank_transfer.

Response

The created invoice.

A request for payment you send a customer. Slash emails it, hosts a payment page at payUrl, matches incoming deposits to it and keeps its status and amounts up to date. All amounts are in USD.

string

required

Invoice id with the inv_ prefix.

Example:

"inv_2rj4l7hmrrrcv"

number

string

required

Unique per legal entity.

Example:

"INV-1042"

status

enum<string>

required

See Invoice lifecycle.

Available options:

scheduled,

unpaid,

partially_paid,

paid,

void

overdue

boolean

required

Whether the invoice is unpaid or partially_paid and its due date has passed in its timezone.

accountId

string

required

The account payments settle into, with the sa_group_ prefix.

Example:

"sa_group_2rj4l7hmrrrcv"

issueDate

string<date>

required

dueDate

string<date>

required

timezone

string

required

The IANA timezone the invoice's dates are in.

Example:

"America/New_York"

lineItems

InvoiceLineItem · object[]

required

Hide child attributes

lineItems.name

string

required

Example:

"Robot arm maintenance"

lineItems.quantity

number

required

Example:

2

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

quantity times unitAmount.

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}$

lineItems.catalogItemId

string

The catalog item the line was added from, with the cat_item_ prefix. The line keeps the name and price it was written with.

amounts

object

required

Hide child attributes

amounts.subtotal

Money · object

required

The line items' totals added up.

Hide child attributes

amounts.subtotal.amount

integer

required

Amount in the currency's minor units.

amounts.subtotal.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.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.total

Money · object

required

What the customer owes in all.

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.paid

Money · object

required

What has been paid so far.

Hide child attributes

amounts.paid.amount

integer

required

Amount in the currency's minor units.

amounts.paid.currency

string

required

Uppercase ISO 4217 currency code.

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

amounts.outstanding

Money · object

required

What is still owed. Zero once the invoice is paid or void.

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}$

ccEmails

string[]

required

Also copied on the invoice and its reminders.

billedTo

object

required

The customer's details as they were when the invoice was created.

Hide child attributes

billedTo.name

string

required

billedTo.email

string

required

billedTo.address

Address · object

Hide child attributes

billedTo.address.line1

string

required

Minimum string length: 1

billedTo.address.city

string

required

Minimum string length: 1

billedTo.address.line2

string

billedTo.address.state

string

billedTo.address.postalCode

string

billedTo.address.countryCode

string

ISO 3166-1 alpha-2 country code.

Required string length: 2

paymentMethods

InvoicePaymentMethod · object[]

required

Hide child attributes

paymentMethods.type

enum<string>

required

bank_transfer (ACH, wire or realtime payment to the account's details) is always offered.

Available options:

bank_transfer,

ach_debit,

card,

crypto

paymentMethods.passFeeToPayer

boolean

required

Whether the payer covers the method's processing fee.

payments

InvoicePayment · object[]

required

Oldest first.

Hide child attributes

payments.id

string

required

Payment id with the inv_tr_link_ prefix. Remove it with DELETE /v2/invoices/{invoiceId}/payments/{paymentId}.

Example:

"inv_tr_link_2rj4l7hmrrrcv"

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.paidOn

string<date>

required

The day the payment arrived, in the invoice's timezone.

payments.method

enum<string>

required

How the money arrived.

Available options:

ach,

wire,

international_wire,

realtime,

ach_debit,

card,

crypto,

other

payments.matchedBy

enum<string>

required

automatic when Slash matched the deposit or the payer paid on the payment page; manual when it was recorded by hand.

Available options:

automatic,

manual

payments.createdAt

string<date-time>

required

When the payment was recorded.

payments.transactionId

string

The deposit, with the agg_tx_ prefix, readable at GET /v2/transactions/{transactionId}. Absent for payments received outside Slash.

Example:

"agg_tx_2rj4l7hmrrrcv"

payUrl

string

required

The hosted page where the customer views and pays the invoice.

documentId

string

required

The invoice's PDF, with the st_ prefix. Download it with GET /v2/documents/{documentId}. Each edit issues a new PDF.

Example:

"st_2rj4l7hmrrrcv"

createdAt

string<date-time>

required

customerId

string

Customer id with the le_cus_ prefix.

Example:

"le_cus_2rj4l7hmrrrcv"

virtualAccountId

string

The virtual account payments settle into, with the subaccount_ prefix. Absent when they settle into the account's primary virtual account.

seriesId

string

The recurring series that issued the invoice, with the inv_series_ prefix.

scheduledSendDate

string<date>

When a scheduled invoice will be emailed, at 9:00 in its timezone.

discount

Percentage · object

Taken off the line items' subtotal before tax.

Percentage
Fixed

Hide child attributes

discount.type

enum<string>

required

Available options:

percentage

discount.percent

number

required

Percent of the subtotal. 10 means 10%.

Example:

10

taxRate

number

Tax as a percent of the subtotal after the discount. 8.5 means 8.5%.

Example:

8.5

memo

string

A note printed on the invoice.

nextReminderAt

string<date-time>

When the next automatic reminder is due to go out.

paidAt

string<date-time>

When the invoice became paid.

voidedAt

string<date-time>

When the invoice was voided.

⌘I

Create an invoice

curl --request POST \
  --url https://api.slash.com/v2/invoices \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --header 'X-Idempotency-Key: <x-idempotency-key>' \
  --header 'x-legal-entity: <x-legal-entity>' \
  --data '
{
  "customerId": "le_cus_2rj4l7hmrrrcv",
  "issueDate": "2026-10-01",
  "dueDate": "2026-10-31",
  "timezone": "America/New_York",
  "lineItems": [
    {
      "name": "Design retainer",
      "quantity": 1,
      "unitAmount": {
        "amount": 450000,
        "currency": "USD"
      }
    },
    {
      "name": "Extra hours",
      "quantity": 6,
      "unitAmount": {
        "amount": 15000,
        "currency": "USD"
      }
    }
  ],
  "taxRate": 8.5,
  "paymentMethods": [
    {
      "type": "bank_transfer"
    },
    {
      "type": "card",
      "passFeeToPayer": true
    }
  ]
}
'

const options = {
  method: 'POST',
  headers: {
    'X-Idempotency-Key': '<x-idempotency-key>',
    'x-legal-entity': '<x-legal-entity>',
    'X-API-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    customerId: 'le_cus_2rj4l7hmrrrcv',
    issueDate: '2026-10-01',
    dueDate: '2026-10-31',
    timezone: 'America/New_York',
    lineItems: [
      {
        name: 'Design retainer',
        quantity: 1,
        unitAmount: {amount: 450000, currency: 'USD'}
      },
      {name: 'Extra hours', quantity: 6, unitAmount: {amount: 15000, currency: 'USD'}}
    ],
    taxRate: 8.5,
    paymentMethods: [{type: 'bank_transfer'}, {type: 'card', passFeeToPayer: true}]
  })
};

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

import requests

url = "https://api.slash.com/v2/invoices"

payload = {
    "customerId": "le_cus_2rj4l7hmrrrcv",
    "issueDate": "2026-10-01",
    "dueDate": "2026-10-31",
    "timezone": "America/New_York",
    "lineItems": [
        {
            "name": "Design retainer",
            "quantity": 1,
            "unitAmount": {
                "amount": 450000,
                "currency": "USD"
            }
        },
        {
            "name": "Extra hours",
            "quantity": 6,
            "unitAmount": {
                "amount": 15000,
                "currency": "USD"
            }
        }
    ],
    "taxRate": 8.5,
    "paymentMethods": [
        { "type": "bank_transfer" },
        {
            "type": "card",
            "passFeeToPayer": True
        }
    ]
}
headers = {
    "X-Idempotency-Key": "<x-idempotency-key>",
    "x-legal-entity": "<x-legal-entity>",
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

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

print(response.text)

package main

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

func main() {

	url := "https://api.slash.com/v2/invoices"

	payload := strings.NewReader("{\n  \"customerId\": \"le_cus_2rj4l7hmrrrcv\",\n  \"issueDate\": \"2026-10-01\",\n  \"dueDate\": \"2026-10-31\",\n  \"timezone\": \"America/New_York\",\n  \"lineItems\": [\n    {\n      \"name\": \"Design retainer\",\n      \"quantity\": 1,\n      \"unitAmount\": {\n        \"amount\": 450000,\n        \"currency\": \"USD\"\n      }\n    },\n    {\n      \"name\": \"Extra hours\",\n      \"quantity\": 6,\n      \"unitAmount\": {\n        \"amount\": 15000,\n        \"currency\": \"USD\"\n      }\n    }\n  ],\n  \"taxRate\": 8.5,\n  \"paymentMethods\": [\n    {\n      \"type\": \"bank_transfer\"\n    },\n    {\n      \"type\": \"card\",\n      \"passFeeToPayer\": true\n    }\n  ]\n}")

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

	req.Header.Add("X-Idempotency-Key", "<x-idempotency-key>")
	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": "inv_2rj4l7hmrrrcv",
  "number": "INV-1042",
  "status": "scheduled",
  "overdue": true,
  "accountId": "sa_group_2rj4l7hmrrrcv",
  "issueDate": "2023-12-25",
  "dueDate": "2023-12-25",
  "timezone": "America/New_York",
  "lineItems": [
    {
      "name": "Robot arm maintenance",
      "quantity": 2,
      "unitAmount": {
        "amount": 123,
        "currency": "<string>"
      },
      "total": {
        "amount": 123,
        "currency": "<string>"
      },
      "catalogItemId": "<string>"
    }
  ],
  "amounts": {
    "subtotal": {
      "amount": 123,
      "currency": "<string>"
    },
    "discount": {
      "amount": 123,
      "currency": "<string>"
    },
    "tax": {
      "amount": 123,
      "currency": "<string>"
    },
    "total": {
      "amount": 123,
      "currency": "<string>"
    },
    "paid": {
      "amount": 123,
      "currency": "<string>"
    },
    "outstanding": {
      "amount": 123,
      "currency": "<string>"
    }
  },
  "ccEmails": [
    "<string>"
  ],
  "billedTo": {
    "name": "<string>",
    "email": "<string>",
    "address": {
      "line1": "<string>",
      "city": "<string>",
      "line2": "<string>",
      "state": "<string>",
      "postalCode": "<string>",
      "countryCode": "<string>"
    }
  },
  "paymentMethods": [
    {
      "type": "bank_transfer",
      "passFeeToPayer": true
    }
  ],
  "payments": [
    {
      "id": "inv_tr_link_2rj4l7hmrrrcv",
      "amount": {
        "amount": 123,
        "currency": "<string>"
      },
      "paidOn": "2023-12-25",
      "method": "ach",
      "matchedBy": "automatic",
      "createdAt": "2023-11-07T05:31:56Z",
      "transactionId": "agg_tx_2rj4l7hmrrrcv"
    }
  ],
  "payUrl": "<string>",
  "documentId": "st_2rj4l7hmrrrcv",
  "createdAt": "2023-11-07T05:31:56Z",
  "customerId": "le_cus_2rj4l7hmrrrcv",
  "virtualAccountId": "<string>",
  "seriesId": "<string>",
  "scheduledSendDate": "2023-12-25",
  "discount": {
    "type": "percentage",
    "percent": 10
  },
  "taxRate": 8.5,
  "memo": "<string>",
  "nextReminderAt": "2023-11-07T05:31:56Z",
  "paidAt": "2023-11-07T05:31:56Z",
  "voidedAt": "2023-11-07T05:31:56Z"
}

Banking

Money movement

Bill pay

Invoicing

Accounting

Platform

Create an invoice

Authorizations

Headers

Body

Response