POS API Reference
HomeSimpra POSSimpra InventoryCheck&Place
HomeSimpra POSSimpra InventoryCheck&Place
  1. Checks
  • Introduction
  • Overview
  • External API Action Scenarios
  • Checks
    • Get Checks
      GET
    • Add Discount to Check
      POST
    • Get Check
      GET
    • Add Payment to Check
      POST
    • Add Portal Plus Invoice Id to Check
      POST
    • Add Service Charge to Check
      POST
    • Add Service Message To Check
      POST
    • Cancel Check Item
      POST
    • Change Delivery Status
      POST
    • Create Check Item
      POST
    • Create Check
      POST
    • Remove Check Discount
      DELETE
    • Remove Check Service Charge
      DELETE
    • Unlock Check
      POST
    • Get Check Activities
      GET
    • Add Note to Check
      POST
  • Menu Items
    • Get Menu Items
    • Get Menu Item
    • Create Menu Items
    • Update Menu Items
    • Upsert Menu Items
    • Remove Menu Item Report Tags
  • Menu Item Definitions
    • Get Menu Item Definitions
  • Menu Item Groups
    • Get Menu Item Groups
  • Item Definitions
    • Get Item Definitions
    • Update Item Definitions
  • Condiments
    • Get Condiments
  • Condiment Groups
    • Get Condiment Groups
  • ComboMenus
    • Get ComboMenus
  • Custom Menu Items
    • Get Custom Menu Items
  • Customers
    • Get Customers
    • Add Customer
    • Update Customer
  • CustomerDiscounts
    • Get CustomerDiscounts
  • Employees
    • Get Employees
  • Properties
    • Get Properties
  • Accounting API
    • Get Enterprise
    • Get Property
    • Get Enterprises
    • Get Payment
    • Get Payments
    • Get Future Payments
    • Get Dealers
  • Cash Trackings
    • Get Cash Trackings
  • Currencies
    • Get Currencies
  • Current Accounts
    • Get Current Accounts
  • Daily Totals
    • Get Daily Totals
  • Devices
    • Get Devices
  • Discounts
    • Get Discounts
  • Imports
    • Get Imports
  • Opera Checks
    • Index
    • Mark As Sent Opera Pms Check
  • Payment Types
    • Get Payment Types
  • Price Lists
    • Get Price Lists
    • Get Price List
    • Create Price List
    • Create Price List with Sku
    • Update Price List
    • Delete Price List
    • Update Price List Items
    • Delete Price List Items
    • Update Price List Items with Sku
    • Delete Price List Items with Sku
  • Reason Payments
    • Get Reason Payments
  • Reasons
    • Get Reasons
  • Report Tags
    • Get Report Tags
    • Add Report Tag
    • Update Report Tag
  • Revenue Centers
    • Get Revenue Centers
  • Sales Channels
    • Get Sales Channels
  • Scheduled Jobs
    • Get Scheduled Job
    • Create Scheduled Job
    • Create Scheduled Job with Sku
    • Update Scheduled Job
    • Update Scheduled Job with Sku
  • Section Things
    • Get Section Things
  • Sections
    • Get Sections
  • Service Charges
    • Get Service Charges
  • Shifts
    • Get Shifts
    • Get Shift
  • Tables
    • Get Tables
  • Tags
    • Get Tags
  • Taxes
    • Get Taxes
  • Z Reports
    • Get Z Reports
  • Schemas
    • Schemas
      • PaginationMeta
      • Translation
      • Metafield
      • Error
      • Check
      • Customer
      • CustomerSummary
      • CustomerAccountDetail
      • MenuItem
      • Employee
      • Property
      • Enterprise
      • RevenueCenter
      • Table
      • SalesChannel
      • Delivery
      • CheckServiceCharge
      • CheckSummary
      • CheckDiscount
      • CheckPayment
      • CheckItem
      • CheckItemSummary
      • CheckOffer
      • Tax
      • Item
      • Device
      • Tag
      • ItemDefinition
      • CondimentGroup
      • DailyTotals
      • CreateCheckRequest
      • CreateCheckItemRequest
      • AddCheckPaymentRequest
      • AddCheckDiscountRequest
      • CreateCustomerRequest
      • CustomerAddressRequest
      • CustomerInvoiceRequest
      • UpdateCustomerRequest
      • CreateMenuItemRequest
      • UpdateMenuItemRequest
  1. Checks

Create Check

Production
https://api.simpra.app
Production
https://api.simpra.app
POST
https://api.simpra.app
/apps/api/v1/checks
Last modified:2026-07-30 09:23:14
Required menu_items[].id.
Required menu_items[].condiments[].id.
Required menu_items[].id.
Required menu_items[].unit_amount.
Tax and menu item group are needed on extension settings.
Required menu_items[].name.
Required menu_items[].unit_amount.
Required discounts[].amount.
Required customer.phone_number.
Creates new customer in enterprise when phone number not using.
Revenue center type should be takeaway on extension settings.
Body Parameters
ParameterDefaultDescriptionRequired
menu_items[]contains order itemsREQUIRED
menu_items[].idordered menu item id
menu_items[].quantity1ordered menu item quantity
menu_items[].nameordered menu item name for custom menu item
menu_items[].unit_amountordered menu item amount for custom menu item
menu_items[].notes[]ordered item notes
menu_items[].condiments[]ordered condiments
menu_items[].condiments[].idcondiment idREQUIRED
menu_items[].combo_items[]ordered combo items
menu_items[].combo_items[].idmenu item idREQUIRED
menu_items[].combo_items[].combo_group_item_idcombo group item idREQUIRED
discounts[]discounts on check
discounts[].amountdiscount amountREQUIRED
table_idcreates check on table
revenue_center_idcreates check on revenue_center
sales_channel_idcreates check on sales_channel
noteadd note to check
alias_namecheck name
female_coverfemale cover on check
male_covermale cover on check
child_coverchild cover on check
customeradd customer to check
customer.phone_numbercustomer phone numberREQUIRED
customer.first_namecustomer first name
customer.last_namecustomer last name
customer.emailcustomer email
customer.gendergender info(female or male)
deliverydelivery information for takeaway
delivery.addressdelivery addressREQUIRED
delivery.notedelivery note
extras[]check custom attributes
extras[].keycheck custom attribute key
extras[].valuecheck custom attribute value

Request

Authorization
Add parameter in header
Simpra-Access-Token
Example:
Simpra-Access-Token: ********************
Header Params

Body Params application/json

Examples

Responses

🟢200OK
application/json
OK
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.simpra.app/apps/api/v1/checks' \
--header 'Simpra-Access-Token: <api-key>' \
--header 'Content-Type: application\json' \
--data-raw '{
    "menu_items": [
        {
            "id": "090de589-398d-4446-b853-ba1ad989dae2",
            "quantity": 1,
            "notes": [
                "hot"
            ],
            "condiments": [
                {
                    "id": "19f7b0f5-fa49-4918-98c4-142ad2a14730"
                }
            ],
            "combo_items": [
                {
                    "id": "3213d733-5311-440b-ad41-92640a7250ff",
                    "combo_group_item_id": "4d0a869e-7bee-4c58-ae25-6d3bf20622f8"
                }
            ],
            "unit_amount": 10,
            "name": "TeaWithCoffee"
        }
    ],
    "discounts": [
        {
            "amount": 10
        }
    ],
    "customer": {
        "phone_number": "319003205832",
        "first_name": "Big",
        "last_name": "BigBrother",
        "email": "big@brother.com",
        "gender": "female"
    },
    "delivery": {
        "address": "BigBrother No.10",
        "note": "Life is short"
    },
    "extras": [
        {
            "key": "iwallet_card_number",
            "value": "1234567890"
        }
    ],
    "note": "fast",
    "table": "249934c8-892e-40ac-aced-ee6338d14388",
    "alias_name": "Brothers",
    "female_cover": 2,
    "male_cover": 2,
    "child_cover": 4,
    "revenue_center_id": "2291e5ec-b0d7-4b98-a273-c644c6f6e756"
}'
Response Response Example
{
    "check": {
        "id": "c2cb6f75-88c1-4ab6-99af-a9d6b7822993",
        "sequence": 111
    }
}
Modified at 2026-07-30 09:23:14
Previous
Create Check Item
Next
Remove Check Discount
Built with