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
- OpenAPI
- Specification ↗
- Spec updated
- 2023-04-19
Make a first request
Replace the placeholders; the documentation says exactly where credentials go.
curl -X GET "https://unify.apideck.com/pos/items" \
-H "Accept: application/json" \
-H "X-API-Key: YOUR_API_KEY"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);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
| Method | Path | What it does |
|---|---|---|
| GET | /pos/items | List Items |
| POST | /pos/items | Create Item |
| GET | /pos/items/{id} | Get Item |
| PATCH | /pos/items/{id} | Update Item |
| DELETE | /pos/items/{id} | Delete Item |
| GET | /pos/locations | List Locations |
| POST | /pos/locations | Create Location |
| GET | /pos/locations/{id} | Get Location |
| PATCH | /pos/locations/{id} | Update Location |
| DELETE | /pos/locations/{id} | Delete Location |
| GET | /pos/merchants | List Merchants |
| POST | /pos/merchants | Create Merchant |
| GET | /pos/merchants/{id} | Get Merchant |
| PATCH | /pos/merchants/{id} | Update Merchant |
| DELETE | /pos/merchants/{id} | Delete Merchant |
| GET | /pos/modifier-groups | List Modifier Groups |
| POST | /pos/modifier-groups | Create 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/modifiers | List Modifiers |
| POST | /pos/modifiers | Create Modifier |
| GET | /pos/modifiers/{id} | Get Modifier |
| PATCH | /pos/modifiers/{id} | Update Modifier |
| DELETE | /pos/modifiers/{id} | Delete Modifier |
| GET | /pos/order-types | List Order Types |
| POST | /pos/order-types | Create 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/orders | List Orders |
| POST | /pos/orders | Create Order |
| GET | /pos/orders/{id} | Get Order |
| PATCH | /pos/orders/{id} | Update Order |
| DELETE | /pos/orders/{id} | Delete Order |
| POST | /pos/orders/{id}/pay | Pay Order |
| GET | /pos/payments | List Payments |
| POST | /pos/payments | Create Payment |
| GET | /pos/payments/{id} | Get Payment |
| PATCH | /pos/payments/{id} | Update Payment |
| DELETE | /pos/payments/{id} | Delete Payment |
| GET | /pos/tenders | List Tenders |
| POST | /pos/tenders | Create 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.
Similar development APIs
Compare alternatives →Cloudflare
DevelopmentManage DNS, CDN, Workers and other services; documented with an official OpenAPI 3.0 spec
Azure DevOps
DevelopmentThe Azure DevOps basic components of a REST API request/response pair
IPify
DevelopmentA simple IP Address API
App Store Connect API
DevelopmentThe data structure that represents an app store connect api resource.
StackExchange
DevelopmentQ&A forum for developers
IPinfo
DevelopmentAnother simple IP Address API
Listed from APIs.guru (CC0).