99minds.io - Docs.99minds.io
99minds APIs
Domain Summary
What IP addresses does Docs.99minds.io resolve to?
• Docs.99minds.io resolves to the IP addresses 44.212.249.103.
Where are Docs.99minds.io servers located in?
• Docs.99minds.io has servers located in Ashburn, Virginia, 20149, United States.
docs.99minds.io Profile
Title:99minds APIs
Description:99minds Gift Card APIs are for developers who want to integrate their application with 99minds Gift Card platform. In this guide you'll learn about basic steps for getting started with 99minds Gift Card APIs, including:
1. Sign up and create account on 99minds Gift Card platform.
2. Generating the required API credentials for API access
3. API tutorials for making API calls to 99minds Gift Card platform
Because the REST API is based on open standards, you can use any web development language to access our APIs.
# Authorization
99minds Gift Card platform uses **`Bearer Token`** authentication. **Bearer authentication** (also called **token authentication**) is an [HTTP authentication scheme](https://developer.mozilla.org/en-US/docs/Web/HTTP/Authentication) that involves security tokens called bearer tokens. The client must send this token in the `Authorization` header when making requests to protected resources:
```
Authorization: Bearer
```
#### Obtaining API credentials
API keys can be obtained by creating an API application in the 99minds platform. Visit `Settings > API` and click on `New Application`. Once you create a new application, you will be presented with the `Key ID` and `Key Secret`.
| Key type | Description |
| --- | --- |
| Key ID | To be used in client-based applications (like browsers using Javascript). |
| Key Secret | To be used in server-based applications. |
#### Obtaining store details
In addition to API keys, every `POST/PUT` method in 99minds requires either a `store_ref` or `client_store_id` in the request body.
Stores on 99minds serve as a representation of each of your physical retail locations on the 99minds platform. For instance, if you have 10 retail stores and wish to track where gift card sales, redemptions, and other transactions occur, you should create 10 corresponding stores on 99minds (found under the Configure > Stores menu) and obtain the associated `store_ref` or `client_store_id`. Each gift card transaction will then be linked to its respective store. However, this is not mandatory. You can opt to use a single store and consistently pass the same `store_ref`/`client_store_id` for all transactions, and that would work as well.
| Key type | Description |
| --- | --- |
| store_ref | Unique store ID generated by 99minds. |
| client_store_id | Unique store ID provided by merchant. |
# Response Format
All responses HTTP status code will always be **`200 OK`**
The `status` key inside the response will state the actual status of the response.
The `code` key inside the response will state the actual error code of the response.
| Key | Description |
| --- | --- |
| data | Response body |
| status | Any one of `OK`, `Unprocessable Entity`, `Not Found`, `Bad Request`, `Missing Parameter(s)`, `Forbidden`, `Unauthorized` |
| code | Any one of `200`, `404`, `422`, `400`, `403`, `401` |
| message | Display message |
| errors | List of errors by keys returned (if any) |
# Pagination
Pagination is provided on all collection APIs.
## Option 1
When large data sets are returned, the results are paginated. In such cases, a pagination section is included in the response, along with the first page of data.returned in the result set. The first page of data will be returned in the response also.
``` json
{
"data": {
"total_records": 137,
"total_pages": 2,
"current_page": 2,
"next_page": null,
"prev_page": 1,
"giftcards": [
{ ... },
{ ... }
... and 98 other giftcards
]
},
"status": "OK",
"code": 200,
"message": null,
"errors": []
}
```
#### Requesting Pages
You can request a different page by passing a different `page` parameter like:
```
/api/v1/giftcards?page=23
```
#### Page size
It is not possible to change the number of objects returned in the response. The default `page_size` is `100`
## Option 2
Requesting subsequent pages is based on a resource specific cursor - an attribute called `version` which can be found on all collection resources. Here’s an example based on the `giftcard` resource:
``` json
{
"version": 13560,
"card_id": "card_f4e0071f9c3c67a811",
"batch_id": null,
"active": true,
"giftcard_number": "SK2670657708",
"original_value": "100.0",
"remaining_value": "100.0",
"expiration_date": null,
"campaign_name": "doboz",
"campaign_id": "campaign_93fb1d07453f5843d8",
"currency": "USD",
"created_at": "2021-10-11T11:36:21.000Z"
}
```
> **NOTE:** _The_ `_version_` _attribute is simply a monotonically increasing integer. It is being incremented every time a resource is changed. This is a global parameter and it shouldn’t be assumed that subsequent versions of the same resource will be incremented by 1._
#### First page
By default, the value of the `min_id` parameter will be assumed as equal `0` so it’s not necessary to use it on the first page. For a request with no `min_id` parameter or `min_id=0`, the first page of products will be returned, even if a resource with `version = 0` may not exist in the given collection. The body of the response will contain `version` with the lowest and highest version number of resources included in the response.
``` json
{
"data": {
"total_records": 2156,
"total_pages": 22,
"current_page": 1,
"next_page": 2,
"prev_page": null,
"version": {
"min": 13427,
"max": 13560
},
"giftcards": [
{ ... },
{ ... }
... and 98 other giftcards
]
},
"status": "OK",
"code": 200,
"message": null,
"errors": []
}
```
#### Subsequent pages
The response to that request should include a collection of `0` to `n` resources. The upper limit will probably be different depending on the endpoint. The highest `version` number `x` from this collection (the `max` attribute above) should be used to request the next page like:
```
/api/v1/giftcards?min_id=x
```
This should be repeated until an empty collection is returned. This will mean that all items of the collection have been returned.
#### Sorting
Objects in returned collections will be sorted by the `sort` parameter which can be either `asc` or `desc`. Defaults to `desc`
# Rate Limits
99minds rate limits all API requests in a 60-second window. The rate limits are same for all plans.
It allows 150 requests per minute (rpm) per IP address. The API returns an HTTP status code of 429 when rate limited and HTTP status code of 503 when an IP is banned.
> **Note** : Other than artificially rate-limits on the basis of API-requests-per-unit-of-time, there are physical limits to the infrastructure which may limit the maximum throughput of requests on any given API endpoint. 99minds also reserves the right to limit unreasonable or abusive API activity in the interest of platform stability and may even block such requests.
99minds exposes rate limit positioning to applications using the following response headers:
| Header | Example value |
| --- | --- |
| X-RateLimit-Limit | 1 |
| X-RateLimit-Remaining | 0 |
| X-RateLimit-Reset | 1652820860 |
# Status Codes
When 99minds receives a request to an API endpoint, a number of different HTTP status codes can be returned in the response depending on the original request.
| Code | Description |
| --- | --- |
| 200 | The request was successfully processed by 99minds. |
| 400 | The request was not understood by the server, generally due to bad syntax or because the Content-Type header was not correctly set to application/json. This status is also returned when the request provides an invalid code parameter during the OAuth token exchange process. |
| 401 | The necessary authentication credentials are not present in the request or are incorrect. |
| 403 | The server is refusing to respond to the request. This is generally because you have not requested the appropriate scope for this action. |
| 404 | The requested resource was not found but could be available again in the future. |
| 422 | The request body was well-formed but contains semantical errors. The response body will provide more details in the errors parameter. |
| 429 | The request was not accepted because the application has exceeded the rate limit. See the API Call Limit documentation for a breakdown of 99minds's rate-limiting mechanism. |
| 500 | An internal error occurred in 99minds. Please post to the API & support forum so that 99minds staff can investigate. |
| 501 | The requested endpoint is not available on that particular shop, e.g. requesting higher plan specific API on a shop running on a start-up plan. This response may also indicate that this endpoint is reserved for future use. |
| 503 | The server is currently unavailable. Check the status page for reported service outages. |
| 504 | The request could not complete in time. Try breaking it down in multiple smaller requests. |
What technologies does docs.99minds.io use?
These are the technologies used at docs.99minds.io. docs.99minds.io has a total of 3 technologies installed in 3 different categories.
docs.99minds.io Traffic Analysis
There's no enough data about docs.99minds.io traffic.Daily Visitors n/a
Monthly Visits n/a
Pages per Visit n/a
Visit duration n/a
Bounce Rate n/a
Is this your site?Verify your site's metrics.
- Daily Unique Visitors:
- n/a
- Monthly Visits:
- n/a
- Pages per Visit:
- n/a
- Daily Pageviews:
- n/a
- Avg. visit duration:
- n/a
- Bounce rate:
- n/a
- Global Reach:
- n/a
- HypeRank:
- n/a
Last update was 57 days ago
This can take up to 60 seconds. Please wait...
This can take up to 60 seconds. Please wait...
*HypeStat.com is not promoting or affiliated with 99minds.io in any way. Only publicly available statistics data are displayed.
▼
SEMrush is a complete on line advertising and marketing platform that gives a extensive variety of gear and functions to help companies and entrepreneurs in enhancing their on line visibility and optimizing their virtual advertising and marketing strategies.- Domain:
- docs.99minds.io
- Rank:
(Rank based on keywords, cost and organic traffic) - n/a
- Organic Keywords:
(Number of keywords in top 20 Google SERP) - 0
- Organic Traffic:
(Number of visitors coming from top 20 search results) - 0
- Organic Cost:
((How much need to spend if get same number of visitors from Google Adwords) - $0.00
Ad Experience Report ▼
Summary of the ad experience rating of a website for a specific platform.Mobile summary
- Root domain:
- 99minds.io
- Ad filtering:
(Chrome is not filtering ads on your site.) - Off
- Status:
(The status of the site that is reviewed for the Better Ads Standards.) - Not reviewed
Desktop summary
- Root domain:
- 99minds.io
- Ad filtering:
(Chrome is not filtering ads on your site.) - Off
- Status:
(The status of the site that is reviewed for the Better Ads Standards.) - Not reviewed
Abusive Experience Report ▼
Summary of the abusive experience rating of a website.- Root domain:
- 99minds.io
- Enforcement:
(Chrome is not preventing your site from opening new windows or tabs.) - Off
- Status:
(The status of the site reviewed for the abusive experiences.) - Not reviewed
Where is docs.99minds.io hosted? ▼
Docs.99minds.io may be hosted in multiple data centers distributed in different locations around the world. This is probably just one of them.- Server IP:
- 44.212.249.103
- ASN:
- AS14618
- ISP:
- Amazon.com, Inc.
- Server Location:
- Ashburn
Virginia, VA
20149
United States, US
Other sites hosted on 44.212.249.103
There are no other sites hosted on this IPHow fast does docs.99minds.io load? ▼
The average loading time of docs.99minds.io is 2315 ms.- Average Load Time:
- 2315 ms
Does docs.99minds.io use compression? ▼
Website compression is the process of reducing the size of website files, such as HTML, CSS, JavaScript, and image files, to improve website performance and load times. Compressing website files can significantly reduce the amount of data that needs to be transferred from the server to the user's browser, resulting in faster page load times and improved user experience. Files on docs.99minds.io are reduced by 67%.
docs.99minds.io use gzip compression.
Original size: 50.53 KB
Compressed size: 16.18 KB
File reduced by: 34.35 KB (67%)
Compressed size: 16.18 KB
File reduced by: 34.35 KB (67%)
Google Safe Browsing ▼
Google Safe Browsing is a service provided by Google that helps protect users from visiting websites that may contain malicious or harmful content, such as malware, phishing attempts, or deceptive software.SSL Checker - SSL Certificate Verify ▼
An SSL (Secure Sockets Layer) certificate is a digital certificate that establishes a secure encrypted connection between a web server and a user's web browser. It provides authentication and encryption, ensuring that data transmitted between the server and the browser remains private and protected. docs.99minds.io supports HTTPS. docs.99minds.io supports HTTPS
Verifying SSL Support. Please wait...
Common Name: docs.99minds.io
Organization:
Location:
Issuer: R10
Valid from: May 12 13:37:38 2025 GMT
Valid until: Aug 10 13:37:37 2025 GMT
Authority: CA:FALSE
Keysize: 4096 Bits
Organization:
Location:
Issuer: R10
Valid from: May 12 13:37:38 2025 GMT
Valid until: Aug 10 13:37:37 2025 GMT
Authority: CA:FALSE
Keysize: 4096 Bits
Common Name: R10
Organization: Let's Encrypt
Location: US
Issuer: ISRG Root X1
Valid from: Mar 13 00:00:00 2024 GMT
Valid until: Mar 12 23:59:59 2027 GMT
Authority: CA:TRUE
Keysize: 2048 Bits
Organization: Let's Encrypt
Location: US
Issuer: ISRG Root X1
Valid from: Mar 13 00:00:00 2024 GMT
Valid until: Mar 12 23:59:59 2027 GMT
Authority: CA:TRUE
Keysize: 2048 Bits
Verify HTTP/2 Support ▼
HTTP/2 (Hypertext Transfer Protocol version 2) is a major revision of the HTTP protocol, which is the foundation of data communication on the World Wide Web. It was developed as an improvement over the previous HTTP/1.1 version to enhance web performance and efficiency. docs.99minds.io does not support HTTP/2
Verifying HTTP/2.0 Support. Please wait...
Http Header ▼
HTTP headers are extra portions of records despatched among a consumer (which include an internet browser) and a server at some stage in an HTTP request or response. They offer instructions, metadata, or manipulate parameters for the conversation among the consumer and server.x-srv-trace: v=1;t=4a2687d269908da2
x-srv-span: v=1;s=736099fb2aeb109b
date: Thu, 05 Jun 2025 08:51:04 GMT
content-type: text/html; charset=utf-8
transfer-encoding: chunked
connection: close
content-security-policy: font-src 'self' *.getpostman.com documenter.postman.com fonts.gstatic.com fonts.googleapis.com *.pstmn.io; frame-ancestors 'none'; img-src * data:; script-src 'self' 'unsafe-inline' 'strict-dynamic' *.getpostman.com documenter.postman.com documenter-assets.pstmn.io content.pstmn.io run.pstmn.io https://cdn.ravenjs.com 'nonce-9pj938/DZ/L+bKEU/SOz5OfqyqrmNB67SarA8cAfR8D/7y75'; style-src 'self' 'unsafe-inline' *.getpostman.com documenter.postman.com *.pstmn.io fonts.gstatic.com fonts.googleapis.com; frame-src https://youtube.com https://www.youtube.com https://player.vimeo.com
x-content-security-policy: font-src 'self' *.getpostman.com documenter.postman.com fonts.gstatic.com fonts.googleapis.com *.pstmn.io; frame-ancestors 'none'; img-src * data:; script-src 'self' 'unsafe-inline' 'strict-dynamic' *.getpostman.com documenter.postman.com documenter-assets.pstmn.io content.pstmn.io run.pstmn.io https://cdn.ravenjs.com 'nonce-9pj938/DZ/L+bKEU/SOz5OfqyqrmNB67SarA8cAfR8D/7y75'; style-src 'self' 'unsafe-inline' *.getpostman.com documenter.postman.com *.pstmn.io fonts.gstatic.com fonts.googleapis.com; frame-src https://youtube.com https://www.youtube.com https://player.vimeo.com
x-webkit-csp: font-src 'self' *.getpostman.com documenter.postman.com fonts.gstatic.com fonts.googleapis.com *.pstmn.io; frame-ancestors 'none'; img-src * data:; script-src 'self' 'unsafe-inline' 'strict-dynamic' *.getpostman.com documenter.postman.com documenter-assets.pstmn.io content.pstmn.io run.pstmn.io https://cdn.ravenjs.com 'nonce-9pj938/DZ/L+bKEU/SOz5OfqyqrmNB67SarA8cAfR8D/7y75'; style-src 'self' 'unsafe-inline' *.getpostman.com documenter.postman.com *.pstmn.io fonts.gstatic.com fonts.googleapis.com; frame-src https://youtube.com https://www.youtube.com https://player.vimeo.com
x-frame-options: DENY
strict-transport-security: max-age=31536000; includeSubDomains; preload
x-content-type-options: nosniff
referrer-policy: no-referrer-when-downgrade
x-xss-protection: 1; mode=block
access-control-allow-origin: https://phs.getpostman.com
access-control-allow-credentials: true
access-control-expose-headers:
etag: W/"ca1d-cwADnpwaigV0pj6flw+FOROu4/Y"
Vary: Accept-Encoding
content-encoding: gzip
cf-cache-status: DYNAMIC
set-cookie: __cf_bm=aCCXPG8vWXXI6FRYmhSsqnYj6PMo3VpJYGaoL43kaFg-1749113464-1.0.1.1-s3t46TzaD06nK4v_dbBf07HpkAoeOM0sIvCA5DzLaCgaXpNPqCgD4AV41nB9DNEEP20oAsasWkNH5i2B.FBgi2YhT7Q3aH5nI_Y3cq7CUAs; path=/; expires=Thu, 05-Jun-25 09:21:04 GMT; domain=.getpostman.com; HttpOnly; Secure; SameSite=None
server: cloudflare
cf-ray: 94ae6d02793e8212-IAD
DNS Lookup ▼
DNS entries (Domain Name System) are a critical component of the Internet infrastructure. They act as directories that translate human-readable domain names (such as example.com) to machine-readable IP addresses. DNS records are stored on DNS servers and help forward internet traffic efficiently.| Type | Ip | Target/Txt | TTL |
| CNAME | 3600 |