How can we help?

If you want your API to perform tasks on your behalf, that could require authentication, meaning it needs your login credentials. To do so, you'll have to create an API Token. We'll show you the Request you can use to send in the API endpoint, and the Response you'll receive from your API software.

API: Tokens

We'll first define some terms so you have a better understanding of this article.

• Request: This is what you send the API endpoint so it performs a specific task. For example, for the GetAllCustomers function below, you'll paste the Request so the API can get all customer data.

• Response: The API server will give you a Response to your Request. This will indicate if the task was successful, as well as the data you requested.

Keep in mind that Tokens expire every 14 days, or whenever the server undergoes maintenance.

• Request

In this Request, replace fakepassword with your actual password, and login@marktpos.com with your Back End username or email address.

If you are using IT Retail, also replace app.marktpos.com (which is right after POST) with retailnext.itretail.com. Make sure to keep the quotation marks that surround the URL. If you're instead using MarktPOS, leave that part as is.

curl --location --request POST 'https://app.marktpos.com/token?accesslevel=0&securityCode=undefined'; \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=password' \
--data-urlencode 'password=fakepassword' \
--data-urlencode 'username=login@marktpos.com'

• Response

{
    "access_token": "kr-TcZIdlvI8v50ZkULg0xUW6xofdGOVTW5HpH2LaP8G8dr8GvReZf2dRlYGQf9hXVNGetTzOK5DUO5oYPEucvtNOCSW_RTXW5X0CK5Vw1fyyOZgbq1I1wmU7mjzq_SwbmFq_ZE1RiVSaQXv-sjm4Ki_pn8HimzYzJg_s_lm1y1jk6gf3IvMzjxW2UcXDWXi67X69lmY0tKbHTuwV4llUKXDn5--ySXSZvSHTc_Qa9hJpVZmZ6lrXaPhC21qftgayHz7p-F68dhQ7Q0uITTd5inlGphWQIbMAQpup9sZE6fTPRSWfB7sQT0_pZzL6XTM5xuBlD621OkvPmYJNrh-VbEr5upKL8fRLfIGcs18QpBT14RdjIaPpzhwYUnvsue9rZUQ9oOXeTRT1KuvcFlcSky-PPaY8vJvD20p-msE-uZuCaFlXkmUlrlVQopJEW6w7W46EUumD1fx_Od3qwGfHpVUWHk",
    "token_type": "bearer",
    "expires_in": 1209599
}

Related Articles

API: Sections

API: Tokens

POS Manager API Setup

Frequently Asked Questions

Q: I have a question, but I can't find my answer here. How do I get more assistance?

A: If you need immediate assistance, the team is available 24/7. Feel free to contact our support team at 877-752-0625. You can also email us at support@marktpos.com, and we will respond within 24 hours.