RETM | REST API
  1. Invoices
RETM | REST API
  • Developer guide
  • New to our DevPortal 🤔
  • Marketplace Installation Guide
  • Authentication
    • Token
      POST
  • Webhook
    • Overview
    • Invoice Webhooks
      • Webhook Events
      • Invoice Created
    • Orders Webhooks
      • Webhook Events
      • Order Triggeres
    • Menu Webhooks
      • Menu Updates
      • Menu Changed
    • Loyalty Webhooks
      • Promotional Coupon
      • Check Reward
      • Redeem Reward
    • Customer webhook
      • Customer Data
      • Customer hook
    • Error webhook
      • Stay Alert to Connectivity Issues
      • Error webhook
  • Orders
    • Orders
      GET
    • Create Order
      POST
    • Cancel Order
      POST
    • Update delivery order status
      POST
  • Invoices
    • Invoices
      GET
  • Menu
    • Categories
      • List Categories
      • Single Categoy
    • Products
      • Products
      • Single Product
      • Simple List
    • Menu
      GET
  • Branches
    • Branches
      GET
  • Devices
    • Devices
      GET
  • Order type
    • Order types
      GET
    • Create order type
      POST
  • Price Lists
    • Price Lists
  • Payment Methods
    • Payment methods
    • Create pay method
  • Order Charges
    • order charges
    • Create order charges
  • Taxes
    • Tax list
    • Create tax
  • Customers
    • Customers
  1. Invoices

Invoices

GET
https://{serviceID}.retm.sa/api/v2/invoices/list

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************

Responses

🟢200Success
application/json
Body

Example
{
    "items": [
        {
            "event": "order.created",
            "event_type": "create.order",
            "invoice_id": 153,
            "order_refrence": 177,
            "sale_id": null,
            "order_reference": "177",
            "branch_id": "01h1he9gv7jck3xrhg7dz9hzh5",
            "device_id": "01hha45mjava3dc78h84qdp866",
            "created_at": "2025-12-17 19:26:35",
            "total_price": "75.000",
            "subtotal_price": "65.217",
            "tax": "9.783",
            "status": 1,
            "note": "ihnkhkm",
            "taxes": [
                {
                    "id": "01kbz47zwg3ncfskaqt8bqfdrd",
                    "name": {
                        "en": "VAT",
                        "ar": "ضريبة القيمة المضافة"
                    },
                    "amount": "9.783"
                }
            ],
            "payments": [
                {
                    "id": "01GZERV8JPY7PNWM2HJ5RXYG2K",
                    "name": {
                        "en": "Cash",
                        "ar": "نقدي"
                    },
                    "amount": "75.000"
                }
            ],
            "products": [
                {
                    "id": "01kbz4n0degemn5xzcby9eda49",
                    "sku": "10101168",
                    "name": {
                        "ar": "بيكان تشيزكيك",
                        "en": "Pican Cheesecake"
                    },
                    "quantity": "1.000",
                    "total": "19.000",
                    "unit_price": "16.522",
                    "discount_amount": "0.000",
                    "tax": "2.478",
                    "note": null,
                    "category": {
                        "id": "01kbz3jp3tt0ashmtdmmjw4tye",
                        "name": {
                            "ar": "حلويات & كيك",
                            "en": "Sweets & Cakes"
                        }
                    },
                    "variation": {
                        "id": null,
                        "name": null
                    },
                    "modifiers": []
                },
                {
                    "id": "01kbz4n02zq5vjzmtn7w5cqnn3",
                    "sku": "10101156",
                    "name": {
                        "ar": "دونات نوتيلا",
                        "en": "Nutella Donets"
                    },
                    "quantity": "1.000",
                    "total": "11.000",
                    "unit_price": "9.565",
                    "discount_amount": "0.000",
                    "tax": "1.435",
                    "note": null,
                    "category": {
                        "id": "01kbz3jp3tt0ashmtdmmjw4tye",
                        "name": {
                            "ar": "حلويات & كيك",
                            "en": "Sweets & Cakes"
                        }
                    },
                    "variation": {
                        "id": null,
                        "name": null
                    },
                    "modifiers": []
                },
                {
                    "id": "01kbz4n03tggen1t0me5at829g",
                    "sku": "10101157",
                    "name": {
                        "ar": "دونات كيندر",
                        "en": "Kiender Donets"
                    },
                    "quantity": "1.000",
                    "total": "11.000",
                    "unit_price": "9.565",
                    "discount_amount": "0.000",
                    "tax": "1.435",
                    "note": null,
                    "category": {
                        "id": "01kbz3jp3tt0ashmtdmmjw4tye",
                        "name": {
                            "ar": "حلويات & كيك",
                            "en": "Sweets & Cakes"
                        }
                    },
                    "variation": {
                        "id": null,
                        "name": null
                    },
                    "modifiers": []
                },
                {
                    "id": "01kbz4n08br92a3t13ef0emsdn",
                    "sku": "10101162",
                    "name": {
                        "ar": "كيكة الاحلام",
                        "en": "Dream Cake"
                    },
                    "quantity": "1.000",
                    "total": "16.000",
                    "unit_price": "13.913",
                    "discount_amount": "0.000",
                    "tax": "2.087",
                    "note": null,
                    "category": {
                        "id": "01kbz3jp3tt0ashmtdmmjw4tye",
                        "name": {
                            "ar": "حلويات & كيك",
                            "en": "Sweets & Cakes"
                        }
                    },
                    "variation": {
                        "id": null,
                        "name": null
                    },
                    "modifiers": []
                },
                {
                    "id": "01kbz4n07evj4vhbe5m4jr7dt2",
                    "sku": "10101161",
                    "name": {
                        "ar": "تشيز مانجو",
                        "en": "Mango cheesecake"
                    },
                    "quantity": "1.000",
                    "total": "18.000",
                    "unit_price": "15.652",
                    "discount_amount": "0.000",
                    "tax": "2.348",
                    "note": null,
                    "category": {
                        "id": "01kbz3jp3tt0ashmtdmmjw4tye",
                        "name": {
                            "ar": "حلويات & كيك",
                            "en": "Sweets & Cakes"
                        }
                    },
                    "variation": {
                        "id": null,
                        "name": null
                    },
                    "modifiers": []
                }
            ],
            "customer": {
                "id": null,
                "name": null,
                "phone": null,
                "email": null
            },
            "discount": {
                "id": null,
                "amount": "0.000"
            },
            "order_charege": {
                "id": null,
                "amount": "0.000"
            },
            "order_type": {
                "id": "01kbz68nef3ejwqz2yme00rfk4",
                "name": {
                    "en": "Take-Out",
                    "ar": "خارجي"
                }
            },
            "meta": {
                "order_reference": null
            }
        }
    ],
    "pagination": {
        "from": 1,
        "to": 25,
        "per": 25,
        "total": 153,
        "current": 1,
        "path": "https://stg.retm.sa/api/v2/invoices/list"
    }
}
Modified at 2026-01-25 12:56:47
Previous
Update delivery order status
Next
Menu
Built with