Skip to content

POS API API

by apideck.com

API keyHTTPSDevelopment
Open documentation ↗

Overview

Welcome to the POS API. You can use this API to access all POS API endpoints. ## Base URL The base URL for all API requests is `https://unify.apideck.com` We also provide a [Mock API](https://developers.apideck.com/mock-api) that can be used for testing purposes: `https://mock-api.apideck.com` ## Headers Custom headers that are expected as part of the request. Note that [RFC7230](https://tools.ietf.org/html/rfc7230) states header names are case insensitive. | Name | Type | Required | Description | | --------------------- | ------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | | x-apideck-consumer-id | String | Yes | The id of the customer stored inside Apideck Vault. This can be a user id, account id, device id or whatever entity that can have integration within your app. | | x-apideck-service-id | String | No | Describe the service you want to call (e.g., pipedrive). Only needed when a customer has activated multiple integrations for the same Unified API. | | x-apideck-raw | Boolean | No | Include raw response. Mostly used for debugging purposes. | | x-apideck-app-id | String | Yes | The application id of your Unify application. Available at https://app.apideck.com/unify/api-keys. | | Authorization | String | Yes | Bearer API KEY | ## Authorization You can interact with the API through the authorization methods below. <!-- ReDoc-Inject: <security-definitions> --> ## Pagination All API resources have support for bulk retrieval via list APIs. Apideck uses cursor-based pagination via the optional `cursor` and `limit` parameters. To fetch the first page of results, call the list API without a `cursor` parameter. Afterwards you can fetch subsequent pages by providing a cursor parameter. You will find the next cursor in the response body in `meta.cursors.next`. If `meta.cursors.next` is `null` you're at the end of the list. In the REST API you can also use the `links` from the response for added convenience. Simply call the URL in `links.next` to get the next page of results. ### Query Parameters | Name | Type | Required | Description | | ------ | ------ | -------- | ------------------------------------------------------------------------------------------------------------------ | | cursor | String | No | Cursor to start from. You can find cursors for next & previous pages in the meta.cursors property of the response. | | limit | Number | No | Number of results to return. Minimum 1, Maximum 200, Default 20 | ### Response Body | Name | Type | Description | | --------------------- | ------ | ------------------------------------------------------------------ | | meta.cursors.previous | String | Cursor to navigate to the previous page of results through the API | | meta.cursors.current | String | Cursor to navigate to the current page of results through the API | | meta.cursors.next | String | Cursor to navigate to the next page of results through the API | | meta.items_on_page | Number | Number of items returned in the data property of the response | | links.previous | String | Link to navigate to the previous page of results through the API | | links.current | String | Link to navigate to the current page of results through the API | | links.next | String | Link to navigate to the next page of results through the API | ⚠️ `meta.cursors.previous`/`links.previous` is not available for all connectors. ## SDKs and API Clients We currently offer a [Node.js](https://developers.apideck.com/sdks/node), [PHP](https://developers.apideck.com/sdks/php) and [.NET](https://developers.apideck.com/sdks/dot-net) SDK. Need another SDK? [Request the SDK of your choice](https://integrations.apideck.com/request). ## Debugging Because of the nature of the abstraction we do in Apideck Unify we still provide the option to the receive raw requests and responses being handled underlying. By including the raw flag `?raw=true` in your

POS API is a development API from apideck.com. Requests are authenticated with an API key. It is served over HTTPS. Its OpenAPI description documents 46 endpoints.

At a glance

Authentication
API key
HTTPS
Yes
CORS
Unknown
Category
Development
Base URL
https://unify.apideck.com
Version
9.3.0
Endpoints
46
Spec updated
2023-04-19

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://unify.apideck.com/pos/items" \
  -H "Accept: application/json" \
  -H "X-API-Key: YOUR_API_KEY"
JavaScript
const response = await fetch("https://unify.apideck.com/pos/items", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://unify.apideck.com/pos/items",
    headers={
    "Accept": "application/json",
    "X-API-Key": "YOUR_API_KEY",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
GET/pos/itemsList Items
POST/pos/itemsCreate Item
GET/pos/items/{id}Get Item
PATCH/pos/items/{id}Update Item
DELETE/pos/items/{id}Delete Item
GET/pos/locationsList Locations
POST/pos/locationsCreate Location
GET/pos/locations/{id}Get Location
PATCH/pos/locations/{id}Update Location
DELETE/pos/locations/{id}Delete Location
GET/pos/merchantsList Merchants
POST/pos/merchantsCreate Merchant
GET/pos/merchants/{id}Get Merchant
PATCH/pos/merchants/{id}Update Merchant
DELETE/pos/merchants/{id}Delete Merchant
GET/pos/modifier-groupsList Modifier Groups
POST/pos/modifier-groupsCreate Modifier Group
GET/pos/modifier-groups/{id}Get Modifier Group
PATCH/pos/modifier-groups/{id}Update Modifier Group
DELETE/pos/modifier-groups/{id}Delete Modifier Group
GET/pos/modifiersList Modifiers
POST/pos/modifiersCreate Modifier
GET/pos/modifiers/{id}Get Modifier
PATCH/pos/modifiers/{id}Update Modifier
DELETE/pos/modifiers/{id}Delete Modifier
GET/pos/order-typesList Order Types
POST/pos/order-typesCreate Order Type
GET/pos/order-types/{id}Get Order Type
PATCH/pos/order-types/{id}Update Order Type
DELETE/pos/order-types/{id}Delete Order Type
GET/pos/ordersList Orders
POST/pos/ordersCreate Order
GET/pos/orders/{id}Get Order
PATCH/pos/orders/{id}Update Order
DELETE/pos/orders/{id}Delete Order
POST/pos/orders/{id}/payPay Order
GET/pos/paymentsList Payments
POST/pos/paymentsCreate Payment
GET/pos/payments/{id}Get Payment
PATCH/pos/payments/{id}Update Payment
DELETE/pos/payments/{id}Delete Payment
GET/pos/tendersList Tenders
POST/pos/tendersCreate Tender
GET/pos/tenders/{id}Get Tender
PATCH/pos/tenders/{id}Update Tender
DELETE/pos/tenders/{id}Delete Tender

Questions

Does the POS API API need an API key?

Yes. The POS API API uses API key authentication; the documentation explains how to get credentials.

Does the POS API API support HTTPS?

Yes, the POS API API is served over HTTPS.

How many endpoints does the POS API API have?

Its OpenAPI description lists 46 endpoints in version 9.3.0. All of them are shown on this page.

What are alternatives to the POS API API?

Other Development APIs include Cloudflare, Azure DevOps, IPify, App Store Connect API, StackExchange.

Compare alternatives →

Listed from APIs.guru (CC0).