Storyous Public APIs
  1. Bills API
Storyous Public APIs
  • Introduction
  • Merchants API
    • Get merchant and all its places
  • Menu API
    • Get a menu tree
    • Get time-based menu
    • Get Remaining amounts of time-based menu
  • Bills API
    • Get list of payment bills
      GET
    • Get detail of a payment bill
      GET
  • Delivery API
    • Create an order through delivery API
    • Get status of delivery order
  • Deskview API
    • Get list of desks
    • Get list of sections
    • Get desk view of a place
  • Features API
    • Get list of merchants/places with a feature
  • Hotel accounts integration API
    • Provide list of accounts
    • Write consumed items to hotel account
  • Stocks API
    • Get list of stocks
    • Get list of items
    • Get list of stock ups
    • Get detail of stock up
    • Create new stock up
    • Modify stock up
    • Delete stock up
    • Get list of stock takings
    • Get detail of stock taking
    • Create new stock taking
    • Modify stock taking
    • Delete stock taking
    • Get suppliers
  • Loyalty API
    • Introduction
    • Get benefit offer
    • Report offer validation error
    • Report benefit usage
    • Get loyalty benefit usages
    • Mark benefit usages as synchronized
  • DataSync
    • Webhook receiving endpoint
      • Receive new or updated records
    • Data domains
      • Stock management
        • Stocks domain
        • StockItemCategories domain
        • StockItems domain
        • StockMovements domain
      • Sales and costs
        • Bills domain
        • BillCosts domain
        • TerminalTransactions domain
        • PaymentTypes domain
        • Loyalty domain
      • Desks
        • DeskSections domain
        • Desks domain
      • Menu
        • ItemCategories domain
        • Items domain
        • PlaceITems domain
      • Merchants
        • Merchants domain
        • Places domain
        • Persons domain
  • Schemas
    • Schemas
      • Loyalty api
        • BalanceBenefitOfferRequest
        • ThirdPartyLoyaltyOfferRequest
        • LoyaltyOfferValidationError
        • LoyaltyBenefitUsagesPayload
        • BenefitInput
        • PaidItem
        • Applied Benefits
        • PaymentByBalance
        • UsedBalance
        • LoyaltyOfferResponse
        • MenuProductDefinition
        • UsedGeneralDiscount
      • Desk
      • Section
  1. Bills API

Get list of payment bills

GET
https://api.storyous.com/bills/{sourceId}
Get payment bills for a sourceId (merchantId-placeId). Data are ordered by the billId by default. If modifiedSince parameter is present, results will be ordered by the _lastModifiedAt property ascending.

Request

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

Query Params

Responses

🟢200OK
application/json
OK
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.storyous.com/bills/5a75b658f60a3c15009312f1-5a75b658f60a3c15009312f2?from=2016-06-19T10%3A32%3A01Z&till=2017-06-19T10%3A32%3A01Z&modifiedSince=2016-06-19T10%3A32%3A01Z&refunded=true&limit=20&lastBillId=BA2018000001&includeDeleted=true&hasLoyalty=true' \
--header 'Authorization: Bearer <token>'
Response Response Example
{
    "data": [
        {
            "billId": "BA2018000001",
            "sessionCreated": "2018-08-03T14:59:46+02:00",
            "createdAt": "2018-08-03T14:59:48+02:00",
            "paidAt": "2018-08-03T14:59:47+02:00",
            "fiscalizedAt": null,
            "finalPrice": "150.4",
            "finalPriceWithoutTax": "8.26",
            "taxSummaries": {
                "15": "1.74"
            },
            "taxes": [
                {
                    "vat": "15",
                    "totalVat": "1.74",
                    "totalWithoutVat": "8.26"
                }
            ],
            "discount": "0.00",
            "rounding": "0.00",
            "tips": "0.00",
            "currencyCode": "CZK",
            "refunded": false,
            "deleted": false,
            "paymentMethod": "split",
            "payments": [
                {
                    "paymentMethod": "cash",
                    "priceWithVat": "100"
                },
                {
                    "paymentMethod": "card",
                    "priceWithVat": "50.4"
                }
            ],
            "createdBy": {
                "personId": 2187839,
                "fullName": "Person full name",
                "userName": "username"
            },
            "paidBy": {
                "personId": 2187839,
                "fullName": "Person full name",
                "userName": "username"
            },
            "personCount": 1,
            "deskId": null,
            "issuedAsVatPayer": false,
            "fiscalData": [],
            "invoiceData": [],
            "customerId": null,
            "loyaltyOfferId": null,
            "loyaltyProviderId": null,
            "keepLoyaltyBenefitsUsed": true,
            "orderProvider": {
                "code": "dj",
                "orderId": "5a75b658f60a3c15009312f1"
            },
            "_lastModifiedAt": "2018-08-03T14:59:47+02:00"
        }
    ],
    "nextPage": "/bills/5a75b658f60a3c15009312f1-5a75b658f60a3c15009312f2?lastBillId=BA2018000001"
}
Previous
Get Remaining amounts of time-based menu
Next
Get detail of a payment bill
Built with