Skip to content

One invoice

GET
/api/integration/v1/invoices/{id}
curl --request GET \
--url https://api.slflo.com/api/integration/v1/invoices/inv_01J9 \
--header 'Authorization: Bearer <token>'

Needs invoices:read.

id
required
string

Slflo’s id of the invoice, from the invoice feed.

Example

inv_01J9

One invoice

Media typeapplication/json
object
data
required
object
ack
object
acked_at
required
string
acked_version
required
integer format: int64
external_number
string
external_ref
string
message
string
outcome
required
string
reason_code
string
branch
required
object
code
string
external_ref
string
id
required
string
currency
required
string
customer
required
object
code
string
external_ref
string
id
required
string
external_number
string
external_ref
string
handover_id
string
id
required
string
issue_date
required
string
issued_at
required
string
lines
required
Array<object>
object
description
required
string
discount
required
string
is_free_goods
required
boolean
line_number
required
integer format: int32
line_total
required
string
product
required
object
code
string
external_ref
string
id
required
string
promotion_code
string
quantity
required
string
tax
required
Array<object>
object
amount
required
string
code
required
string
rate
required
string
unit
required
object
code
string
external_ref
string
id
required
string
unit_price
required
string
number
required
string
order
required
object
branch
required
object
code
string
external_ref
string
id
required
string
customer
required
object
code
string
external_ref
string
id
required
string
external_number
string
external_ref
string
id
required
string
lines
required
Array<object>
object
discount
required
string
is_free_goods
required
boolean
line_number
required
integer format: int32
product
required
object
code
string
external_ref
string
id
required
string
promotion_code
string
quantity
required
string
unit
required
object
code
string
external_ref
string
id
required
string
unit_price
required
string
number
required
string
sales_rep
required
object
code
string
external_ref
string
id
required
string
status
required
string
prices_include_tax
required
boolean
seq
integer format: int64
status
required
string
tax_submission
object
eta_uuid
string
reason
string
status
required
string
submitted_at
string
totals
required
object
discount
required
string
subtotal
required
string
tax
required
string
total
required
string
updated_at
required
string
version
required
integer format: int64

Example

{
"data": {
"ack": null,
"branch": {
"code": "MAIN",
"external_ref": "CUST-0042/01",
"id": "C0000001:main"
},
"currency": "EGP",
"customer": {
"code": "CUST-1",
"external_ref": "CUST-0042",
"id": "C0000001"
},
"external_number": null,
"external_ref": null,
"handover_id": "ord_01J9X",
"id": "inv_01J9",
"issue_date": "2026-10-05",
"issued_at": "2026-10-05T10:42:00Z",
"lines": [
{
"description": "Cola 330ml",
"discount": "0.00",
"is_free_goods": false,
"line_number": 1,
"line_total": "1430.70",
"product": {
"code": "SKU-COLA",
"external_ref": "ITEM-1001",
"id": "P0000001"
},
"promotion_code": null,
"quantity": "10.000",
"tax": [
{
"amount": "175.70",
"code": "VAT",
"rate": "14.00"
}
],
"unit": {
"code": "CASE",
"external_ref": "cs",
"id": "CASE"
},
"unit_price": "125.50"
}
],
"number": "INV-000041",
"order": {
"branch": {
"code": "MAIN",
"external_ref": "CUST-0042/01",
"id": "C0000001:main"
},
"customer": {
"code": "CUST-1",
"external_ref": "CUST-0042",
"id": "C0000001"
},
"external_number": "SO-0012345",
"external_ref": "SO-0012345",
"id": "ord_01J9X",
"lines": [
{
"discount": "0.00",
"is_free_goods": false,
"line_number": 1,
"product": {
"code": "SKU-COLA",
"external_ref": "ITEM-1001",
"id": "P0000001"
},
"promotion_code": null,
"quantity": "10.000",
"unit": {
"code": "CASE",
"external_ref": "cs",
"id": "CASE"
},
"unit_price": "125.50"
}
],
"number": "SO-000123",
"sales_rep": {
"code": "R012",
"external_ref": "EMP-0451",
"id": "rep_12"
},
"status": "DELIVERED"
},
"prices_include_tax": false,
"seq": 41,
"status": "ISSUED",
"tax_submission": {
"eta_uuid": "3F1D2C9A7B",
"reason": null,
"status": "VALID",
"submitted_at": "2026-10-05T10:42:00Z"
},
"totals": {
"discount": "0.00",
"subtotal": "1255.00",
"tax": "175.70",
"total": "1430.70"
},
"updated_at": "2026-10-05T10:42:00Z",
"version": 9120
}
}

An error: the code says what, retryable whether to try again.

Media typeapplication/json
object
error
required
object
code
required

Stable code, e.g. SCOPE_MISSING, UNKNOWN_REFERENCE.

string
details
required

Field-level problems: {field, code}.

Array<object>
object
key
additional properties
string
message
required

What happened and how to fix it.

string
request_id
required

Quote it to support; it finds the server log.

string
retryable
required

Whether the same call may succeed later.

boolean

Example

{
"error": {
"code": "SCOPE_MISSING",
"details": [],
"message": "This client does not hold the invoices:read scope.",
"request_id": "req_01J9X4Q7T2M8P3NRT6V5WZ",
"retryable": false
}
}