---
updatedAt: 2026-02-25T16:24:44.000Z
agentTools:
  projectIndex: https://documentation.prestmit.io/llms.txt
---

# Service Availability

**Get the availability status of Prestmit services.**

Each service returns either:

- **`true`** → service is available
    
- **`false`** → service is not available
    

This allows you to configure your internal systems so that specific features or actions only run when the corresponding Prestmit service is active.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Prestmit - Partners API",
    "description": "The Prestmit Partners API lets you plug gift-card trading into your product with a few endpoints. Partners can create and track gift-card sell/buy trades, query live rates and availability, and move funds to supported payout rails — all over a stable, JSON-based interface.\n\n**Environments & base URLs**\n\n- **Staging:** `https://dev-2025.prestmit.io/api/partners/v1`\n    \n- **Production:** `https://prestmit.com/api/partners/v1`\n    \n\n**What you can do**\n\n- **Check platform status** before you act (e.g., whether buy/sell, BTC/USDT, or fiat withdrawals are currently available). This helps you gate features in your app.\n    \n- **Trade gift cards (Sell/Buy)**: start a trade for your user and track status through history endpoints.\n    \n- **Fetch rate-calculator data in one call**: categories, sellable/buyable cards, payout methods (NAIRA, CEDIS, BITCOINS, USDT), and conversion hints so you can mirror our calculator UI/logic on your side.\n    \n- **Lookups & utilities**: get bank list for payouts and other lookups to keep your local UI selections in sync with Prestmit.\n    \n- **See current commissions/fees** applied to partner trades, so you can show accurate totals to users.\n    \n\n**Key endpoints in this collection (high-level)**\n\n- **General**\n    \n    - `GET /general/service-availability` – feature flags for core services.\n        \n    - `GET /general/commissions-and-fees` – partner commission/fee percentages.\n        \n    - `GET /general/user` – partner account snapshot (balances, 2FA flags, etc.).\n        \n    - `GET /general/nigerian-banks` – supported NUBAN banks (for payouts).\n        \n- **Gift Card Trade**\n    \n    - **Sell**: `POST /giftcard-trade/sell/create` to start a trade (supports `attachments[]`, optional `uniqueIdentifier`), plus `GET /giftcard-trade/sell/history` for pagination and status tracking.\n        \n    - **Rates**: `GET /giftcard-trade/sell/rate-calculator-data` bundles categories, sellable cards, payout methods, and conversion notes in one response.\n        \n- **Lookup**\n    \n    - Category/card metadata for building your own selectors.\n        \n\n**Reliability patterns built in**\n\n- **Feature gating:** Call **Service Availability** first and conditionally show actions in your app.\n    \n- **Idempotency via references:** Use `uniqueIdentifier` when creating trades so you can reconcile your records with Prestmit’s references later. (See Sell/Create example request.)\n    \n- **Pagination:** History endpoints return standard `links`/`meta` blocks for paging.\n    \n\n**Auth & headers**\n\nAll requests are JSON over HTTPS. Endpoints in this collection show standard `Accept`/`Content-Type` headers; use your partner credentials as described in the Authentication section of the docs (add your key to the Authorization header).\n\n**Who this API is for**  \nFintechs, wallets, and marketplaces that want to let users sell or buy gift cards inside their own product while offloading KYC, pricing, and fulfillment overhead to Prestmit.",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://dev-api.prestmit.io"
    }
  ],
  "components": {
    "securitySchemes": {
      "API_KEY": {
        "type": "apiKey",
        "in": "header",
        "name": "API-KEY",
        "description": "Enter your API KEY here."
      }
    }
  },
  "security": [
    {
      "API_KEY": []
    }
  ],
  "tags": [
    {
      "name": "General",
      "description": "This category contains igh-level utilities to understand account state and platform configuration.\n\nUse these to check whether services are currently live (buy/sell gift cards, withdrawals), fetch your program’s commissions/fees, list supported Nigerian banks, and retrieve the authenticated partner’s profile.\n\nIdeal for health checks and for showing accurate fees/availability in your UI."
    }
  ],
  "paths": {
    "/partners/v1/general/service-availability": {
      "get": {
        "tags": [
          "General"
        ],
        "summary": "Service Availability",
        "description": "**Get the availability status of Prestmit services.**\n\nEach service returns either:\n\n- **`true`** → service is available\n    \n- **`false`** → service is not available\n    \n\nThis allows you to configure your internal systems so that specific features or actions only run when the corresponding Prestmit service is active.",
        "parameters": [
          {
            "name": "Content-Type",
            "in": "header",
            "schema": {
              "type": "string"
            },
            "example": "application/json"
          },
          {
            "name": "Accept",
            "in": "header",
            "schema": {
              "type": "string"
            },
            "example": "application/json"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Date": {
                "schema": {
                  "type": "string",
                  "example": "Sat, 24 Jun 2023 14:26:54 GMT"
                }
              },
              "Server": {
                "schema": {
                  "type": "string",
                  "example": "Apache/2.4.54 (Debian)"
                }
              },
              "X-Powered-By": {
                "schema": {
                  "type": "string",
                  "example": "PHP/8.1.16"
                }
              },
              "Cache-Control": {
                "schema": {
                  "type": "string",
                  "example": "no-cache, private"
                }
              },
              "X-RateLimit-Limit": {
                "schema": {
                  "type": "integer",
                  "example": "100"
                }
              },
              "X-RateLimit-Remaining": {
                "schema": {
                  "type": "integer",
                  "example": "99"
                }
              },
              "Access-Control-Allow-Origin": {
                "schema": {
                  "type": "string",
                  "example": "*"
                }
              },
              "Keep-Alive": {
                "schema": {
                  "type": "string",
                  "example": "timeout=5, max=100"
                }
              },
              "Connection": {
                "schema": {
                  "type": "string",
                  "example": "Keep-Alive"
                }
              },
              "Transfer-Encoding": {
                "schema": {
                  "type": "string",
                  "example": "chunked"
                }
              },
              "Content-Type": {
                "schema": {
                  "type": "string",
                  "example": "application/json"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "buyGiftCard": true,
                  "sellGiftCard": true,
                  "bitcoinWithdrawal": true,
                  "usdtWithdrawal": false,
                  "nairaWalletWithdrawal": true,
                  "cedisWalletWithdrawal": true
                }
              }
            }
          }
        },
        "operationId": "get_partners-v1-general-service-availability"
      }
    }
  },
  "x-readme": {}
}
```