# Showing Items on Second Screen

# Endpoint

http://{terminalIp}/devices/secondscreen/showItems

# Request

Property Type Description
HTTP Headers
Signature String Sha-256 hmac of the JSON payload.
Content-Type text/plain Even if the payload is a JSON object, POS Bridge parses it as a string, therefore it is important to pass content-type as "text/plain" otherwise, the authentication will fail.
JSON
poyntRequestId String UUID of the request.
timeout int Client timeout in milliseconds.
secondScreenRequest object Encloses the properties below.
items JSON Array Property inside printingRequest object. This is an array of OrderItem objects which required fields:

- name

- quantity

- status

- tax

- unifOfMeasure

- unitPrice

For more details, please refer to the API Reference https://poynt.com/docs/api/#model-orderitem
currency String 3 character currency code which determines the currency symbol shown on the second screen.
totalAmount int Amount in cents which should be calculated as the sum of items times their quantity.

# Response

Property Type Description
HTTP Headers
Content-Type application/json Content-type of the payload.
Signature String Sha-256 hmac of the JSON payload.
JSON
poyntRequestId String Echos the value of what was sent in the requestt.

# Request Example

POST /devices/secondscreen/showItems HTTP/1.1
Host: 127.0.0.1:55555
User-Agent: curl/7.43.0
Accept: */*
Content-Type: text/plain
Signature: 3d3719747a9a7f5b08454f6a7a1441990adb9674d83f7c5e8223533652c2ea16
Content-Length: 239
{
    "timeout":70000,
    "poyntRequestId":123525C7-D6A5-4FE2-BAA8-2278E10D5C5F,"
    secondScreenRequest":
    {
        "totalAmount":100,
        "currency":"USD",
        "items":[
            {
                "name":"Milk tea",
                "quantity":1,
                "status":"ORDERED",
                "tax":0,
                "unitOfMeasure":"EACH",
                "unitPrice":100
            }
        ]
    }
}

# Response Example

HTTP/1.1 200 OK
Connection: Keep-Alive
Signature: D5FC3608A12FA5D1EC0D79AD96EECB52987C3B80A44B9243275DAB7DD0D89EEC
Content-Length: 57
Content-Type: application/json <=
{
    "poyntRequestId":"123525C7-D6A5-4FE2-BAA8-2278E10D5C5F"
}
Last Updated: 8/14/2023, 1:52:36 PM