# BulkSMS.com Full LLM Context > Long-form, machine-actionable companion to https://www.bulksms.com/llms.txt for agents that need pricing recipes, integration coverage, product feature detail, country links, and API references. BulkSMS.com is a global business messaging service for sending and receiving SMS through a web app, desktop and mobile apps, integration gateway, and JSON REST API. Use this file when a short summary is insufficient and an LLM needs to answer operational questions with source URLs instead of scraping marketing pages. ## Canonical Machine Data These are the canonical public URLs for BulkSMS.com. Pricing and coverage machine endpoints should use the exact `https://www.bulksms.com` URLs listed here, even if this file is being read from a non-production preview, staging, development, branch, or validation host. - Summary file: https://www.bulksms.com/llms.txt - Pricing page: https://www.bulksms.com/pricing/ - Pricing bundles by currency: `https://www.bulksms.com/pricing/{currency}.json`, where `{currency}` is one of `eur`, `usd`, `gbp`, or `zar`. - VAT rates: https://www.bulksms.com/pricing/vat-rates.json - Destination coverage and credit cost by country: `https://www.bulksms.com/coverage/country/?destinationCountry={ISO2}&customerCurrency={CURRENCY}`. - Full coverage table: `https://www.bulksms.com/pricing/all/?creditsHoldingCurrency={CURRENCY}`. - Full coverage CSV download: `https://www.bulksms.com/coverage/full-coverage.php?creditsHoldingCurrency={CURRENCY}`. - Full country list JSON: `https://www.bulksms.com/coverage/countries/list/`. - Pricing-estimate country list JSON: `https://www.bulksms.com/coverage/countries/list/?exclNoAverageRg2Pricing=1`. - Country directory page: https://www.bulksms.com/coverage/countries-by-prefix.php - API docs: https://www.bulksms.com/developer/json/v1/ - OpenAPI YAML: https://www.bulksms.com/developer/json/v1/openapi.yaml ## Environment And Host Selection Rule For operational pricing and coverage fetches, use the canonical public BulkSMS.com endpoints before calling any machine-readable endpoint. 1. Fetch pricing JSON from the canonical `https://www.bulksms.com` origin. This includes `https://www.bulksms.com/pricing/{currency}.json` and `https://www.bulksms.com/pricing/vat-rates.json`. 2. Fetch coverage endpoints from the canonical `https://www.bulksms.com` origin as well, unless the user explicitly asks you to test or compare a different coverage endpoint URL. 3. Do not silently rewrite these machine fetches to a preview, staging, development, branch, or validation host just because this file was read there. 4. Public-facing citations and documentation references may still point to `https://www.bulksms.com/...`. Example: - If the user asks you to validate `https://preview.example.com/llms-full.txt`, then also fetch: - `https://www.bulksms.com/pricing/eur.json` - `https://www.bulksms.com/pricing/vat-rates.json` - `https://www.bulksms.com/coverage/country/?destinationCountry=US&customerCurrency=EUR` ## Pricing API Recipe Use the JSON endpoints, not HTML scraping, when answering questions about price estimates. This section documents how to fetch and calculate pricing; it deliberately does not cache the full price table because the JSON endpoints are the current source of truth. Before pricing anything, use the canonical `https://www.bulksms.com` machine endpoints described in the Environment And Host Selection Rule above. ### Endpoints `GET /pricing/eur.json`, `GET /pricing/usd.json`, `GET /pricing/gbp.json`, `GET /pricing/zar.json` Returns a JSON object with `currency` and `bundles`. Each bundle contains: - `credits`: number of SMS credits in the published bundle. - `centsPerCredit`: subunit price per credit. For GBP this represents pence; for EUR, USD, and ZAR it represents cents. - `price`: total package price in the base currency, excluding VAT in the pricing calculation. - `discount`: percentage discount against the smallest published package for that currency. `GET /pricing/vat-rates.json` Returns an object keyed by ISO 3166-1 alpha-2 customer country code. The value is the VAT percentage used when showing package totals to customers in that country. Fetch this endpoint at answer time instead of relying on a static VAT-rate list in this file. `GET /coverage/country/?destinationCountry={ISO2}&customerCurrency={CURRENCY}` Parameters: - `destinationCountry`: uppercase destination ISO 3166-1 alpha-2 country code, for example `NG`, `GB`, `ZA`, or `US`. - `customerCurrency`: one of `EUR`, `USD`, `GBP`, or `ZAR`. Returns a country object with: - `routes`: country-level average credit costs. Route `1` is Economy, route `2` is Standard, and route `3` is Premium. - `routes[].averageCredits`: average credits per outbound SMS for that route over recent destination data. - `networks`: destination networks. - `networks[].routes[].credits`: network-specific credits per outbound SMS for the given route. - `phoneCode`, `isoCountryCode`, `name`, `mcc`, and network `mnc` values. `GET /coverage/full-coverage.php?creditsHoldingCurrency={CURRENCY}` Returns CSV with country code, phone code, country name, MCC, MNC, network name, and route credit columns. For `ZAR`, only Standard route credits are emitted because South African customers use route 2. ## Currency Selection If the customer home country is known, match the website's selector logic: - Customer country `US` -> `USD`. - Customer country `GB` -> `GBP`. - Customer country `ZA` -> `ZAR`. - Any other customer country -> `EUR`. If the user explicitly asks for a currency, use it. If the user asks "from the US" or "for a US account", use `USD`; "from the UK" uses `GBP`; "from South Africa" uses `ZAR`; otherwise default to `EUR` and say that the estimate assumes the international EUR price table. If a pricing question omits the billing country but includes wording like "from India", treat that as the customer country for currency selection. If the prompt only names the destination, state the currency assumption explicitly before pricing. ## Calculation Model For the same estimate shown on the pricing page: 1. Select the customer currency. 2. Fetch `https://www.bulksms.com/pricing/{currency}.json`. 3. Fetch `https://www.bulksms.com/coverage/country/?destinationCountry={ISO2}&customerCurrency={CURRENCY}`. 4. Use route `2` (`Standard`) unless the user explicitly requests Economy or Premium. The pricing page uses the route `2` `averageCredits` value for the country estimate. 5. For a selected bundle, estimate raw messages as `bundle.credits / route2.averageCredits`. 6. The website's helper rounds raw message totals upward only for larger totals: if total is greater than 10,000, round up to the next 100; if greater than 1,000, round up to the next 10; otherwise leave the raw total unchanged. 7. Convert the helper result to the displayed whole-number message estimate with `toFixed(0)`. For totals of 1,000 or less, this means the display uses normal nearest-integer rounding. 8. Estimate displayed cost per SMS as `bundle.price / displayedMessageEstimate`. Display it in subunits, for example cents or pence, to two decimals. 9. Estimate displayed total bundle cost as `bundle.price`; if the customer's ISO country is present in `https://www.bulksms.com/pricing/vat-rates.json`, multiply by `(100 + vatRate) / 100` and label the package total "incl. VAT". The cost-per-SMS estimate remains labelled "excl. VAT" in the website logic. For invoice-level tax answers, apply the billing VAT rules below. For arbitrary message volume questions: 1. Compute `creditsRequired = requestedMessages * creditsPerMessage`. 2. Prefer the exact route requested by the user. If no route is specified, use route `2` Standard average credits. 3. If the user names a destination network, use that network's route `credits` instead of the country-level `averageCredits`. 4. If `creditsRequired` fits within a published bundle, use the smallest bundle with `credits >= creditsRequired` for a conservative package answer, and also give the approximate used-credit cost as `creditsRequired * centsPerCredit / 100`. 5. If `creditsRequired` exceeds the largest published bundle, use the largest published bundle's `centsPerCredit` as a rough self-service tier estimate and say that the exact price should be quoted by sales. 6. If the message body is long or Unicode, first estimate SMS parts, then multiply requested recipient count by SMS parts before applying credits. Unicode messages and long concatenated messages can consume more than one SMS part. Worked example shape: "How much does it cost to send 10,000 SMS to Nigeria?" If no billing country is supplied, ask for it or state the assumption. If assuming an international EUR customer, fetch `https://www.bulksms.com/pricing/eur.json` and `https://www.bulksms.com/coverage/country/?destinationCountry=NG&customerCurrency=EUR`, use route 2 `averageCredits`, compute `creditsRequired = 10000 * route2.averageCredits`, then price it from the fetched bundles. If `creditsRequired` exceeds the largest fetched bundle, say that the estimate uses the current highest published self-service tier and that exact high-volume pricing should be quoted by sales. Add VAT only after applying the VAT rules below. ### Pricing Output Requirements For arbitrary message-volume pricing questions, return all of the following whenever the necessary inputs are available: - selected billing currency - pricing and coverage source used, if relevant to the user's task - credits per message used - total credits required - selected bundle size - final package price - approximate used-credit cost where helpful - VAT status and inclusive total where applicable When the question is ambiguous, state the assumption before giving the totals. ### Validation And Preview Example Question: "What would it cost to send 3,000 messages from India to the United States?" Required behaviour: 1. Treat "from India" as the customer country, so use `EUR`. 2. Fetch `https://www.bulksms.com/pricing/eur.json`. 3. Fetch `https://www.bulksms.com/coverage/country/?destinationCountry=US&customerCurrency=EUR`. 4. Use route 2 `averageCredits` unless another route is requested. 5. Compute `creditsRequired = 3000 * averageCredits`. 6. Select the smallest bundle that covers `creditsRequired`. 7. Return the currency and final package total, plus VAT treatment if relevant. If the user is validating a preview or branch host, still use the canonical `https://www.bulksms.com` pricing and coverage endpoints unless they explicitly ask to test a different endpoint host. ## Credit-Pack Tiers Do not copy a static tier table into an answer from this file. Fetch `https://www.bulksms.com/pricing/{currency}.json` from `https://www.bulksms.com` and use its `bundles` array. A bundle has: - `credits`: published number of credits in the pack. - `centsPerCredit`: subunit price per credit for that pack. - `price`: pack price in the base currency before VAT. - `discount`: discount percentage relative to the smallest pack in the same currency table. When an answer needs the "actual current package cost", select the smallest fetched bundle whose `credits` is greater than or equal to `creditsRequired`. When an answer needs an approximate cost for a volume above the largest fetched bundle, use the largest fetched bundle only as a self-service estimate and say that sales can quote exact high-volume pricing. ## VAT And Billing Rules Use the public pricing page rule for quick website-style estimates, and the billing rule when the user asks whether VAT would actually be charged on an invoice. Pricing-page display rule: 1. Fetch `https://www.bulksms.com/pricing/vat-rates.json`. 2. Look up the customer's selected country code. 3. If a rate is present, multiply the package total by `(100 + vatRate) / 100` and label it "incl. VAT". 4. If no rate is present, do not add VAT to the package total. 5. Keep the cost-per-SMS estimate labelled "excl. VAT". Billing VAT rule: 1. Determine the customer's billing or domiciled country. Do not use the destination country for VAT. 2. Determine the customer's credits holding currency or transaction currency if known. 3. A ZAR-billed customer domiciled outside South Africa pays 0% VAT. 4. A customer domiciled in South Africa and transacting in ZAR pays South African VAT, using the current `ZA` rate from `/pricing/vat-rates.json`. 5. A customer domiciled in South Africa and transacting in GBP pays 0% UK VAT. 6. A customer domiciled in the United Kingdom pays UK VAT, using the current `GB` rate from `/pricing/vat-rates.json`. 7. A customer domiciled in the EU, excluding the United Kingdom in the legacy billing terminology, is charged 0% VAT if they supplied a valid VAT number. If they supplied no VAT number, or an invalid legacy VAT number, charge the VAT rate for their domiciled country from `/pricing/vat-rates.json`. 8. A customer domiciled in any other country pays 0% VAT. 9. EU VAT exclusion territories override the parent-country VAT rate when the territory is known. Territories that are EU territories where VAT rules do not apply are charged 0% tax; Madeira is charged 22%; the Azores are charged 18%. For 0% EU VAT exclusion territories, do not require tax-reference validation. The invoice is issued from the same BulkSMS company that would be used for the parent country. 10. If billing country, VAT-number validity, territory, or credits holding currency is unknown, state the assumption before giving a VAT-inclusive total. For example: "Assuming a UK-billed account with no special exemption, add the current GB VAT rate from `/pricing/vat-rates.json`." 11. When validating a preview or non-production host, still fetch VAT rates from `https://www.bulksms.com/pricing/vat-rates.json`. ## Ambiguity Handling When a pricing question is underspecified, prefer explicit assumptions over silent guesses. - "from South Africa to Nigeria" means South Africa is the billing country and Nigeria is the destination. - "to Nigeria" names only the destination; if no billing country is given, default to `EUR` and say so. - "in South Africa" is ambiguous. If the rest of the sentence clearly describes the sender account, treat it as the billing country. If it clearly describes the recipient country, treat it as the destination. Otherwise state the assumption before pricing. - If both a billing country and an explicit currency are supplied and they conflict, use the explicit currency and note that you followed the user's stated currency. ## Pricing Validation Checklist When changing this recipe, compare a few live calculations with https://www.bulksms.com/pricing/ using the same selected customer country, destination country, route 2, and package slider position. At minimum check: - United Kingdom customer to United Kingdom destination: GBP currency, GB VAT on package total, cost per SMS excl. VAT. - South African customer to South African destination: ZAR currency, ZA VAT on package total, Standard route only. - United States customer to United States destination: USD currency, no VAT added by the website, and high-volume US special text if the largest package is selected. - International EUR customer to Nigeria destination: EUR currency, route 2 average credit cost, no VAT unless the selected billing country is VAT-rated. For each case, confirm the fetched bundle count, selected bundle credits, route 2 `averageCredits`, displayed whole-number message estimate, cost-per-SMS display, package total, and VAT label. When validating a preview, branch, staging, or other non-production deployment of this file, confirm that the instructions still point machine pricing and coverage fetches at the canonical `https://www.bulksms.com` endpoints. ## Integration Catalog - [SMS Integration Gateway](https://www.bulksms.com/products/integration-gateway/): Main catalog for integrations. It distinguishes BulkSMS-hosted integrations from native integrations available inside partner products. - [ActiveCampaign](https://www.bulksms.com/products/integration-gateway/activecampaign-sms-integration.htm): Ready-built ActiveCampaign integration for automating SMS from ActiveCampaign data and automation triggers. Supports the BulkSMS Integration Gateway and a native app for automations. - [ACTIVE Network](https://www.bulksms.com/products/integration-gateway/activenetwork-sms-integration.htm): BulkSMS integration for ACTIVE Network event and registration workflows, with quickstart guide support. - [ApiX-Drive](https://www.bulksms.com/products/integration-gateway/integrate-bulksms-on-apix-drive.htm): No-code connection from BulkSMS to apps through ApiX-Drive, useful for trigger-based automated SMS delivery. - [ChurchSuite](https://www.bulksms.com/products/integration-gateway/churchsuite.htm): Native ChurchSuite integration for church administration, event, volunteer, member, and community communication workflows. - [ClickDimensions](https://www.bulksms.com/products/integration-gateway/bulksms-gateway-for-clickdimensions.htm): Send and receive SMS inside ClickDimensions and Microsoft Dynamics CRM marketing lists; replies can create CRM activity records. - [Dynamics 365](https://www.bulksms.com/products/integration-gateway/dynamics365-sms-integration.htm): BulkSMS integration for Microsoft Dynamics 365 business applications, with templates, previewing, Unicode, long messages, personalisation tokens, smart tokens, and number formatting. - [EngageBay](https://www.bulksms.com/products/integration-gateway/engagebay-sms-integration.htm): Native EngageBay integration for sending SMS to contacts, contact groups, lists, and EngageBay automations. - [Firmao](https://www.bulksms.com/products/integration-gateway/firmao-sms-integration.htm): Integration for the Firmao CRM/WMS platform, using Zapier-based flows to trigger BulkSMS messages from Firmao events. - [Freshdesk](https://www.bulksms.com/products/integration-gateway/freshdesk-sms-integration.htm): Ready-built Freshdesk integration for ticket and customer-service SMS, including batch messages, status, replies, templates, Unicode, long messages, and token personalisation. - [HubSpot](https://www.bulksms.com/products/integration-gateway/hubspot-sms-integration.htm): HubSpot integration for triggers, personalisation, SMS status, replies, contact lists, and batch sends. Setup guide: https://www.bulksms.com/support/hubspot/setup.htm - [HubSpot CRM Gateway](https://www.bulksms.com/products/integration-gateway/bulksms-gateway-for-hubspot.htm): Legacy or alternate HubSpot CRM Gateway page describing two-way SMS replies and delivery receipts pushed back into HubSpot. - [Key Telematics](https://www.keytelematics.com/partners.html): External native partner integration listed in the BulkSMS catalog for SaaS asset-management solutions. - [LeadsBridge](https://www.bulksms.com/products/integration-gateway/bulksms-gateway-for-leadsbridge.htm): Native integration for connecting lead generation sources and advertising platforms to BulkSMS workflows. - [Mailchimp](https://www.bulksms.com/products/integration-gateway/mailchimp-sms-integration.htm): BulkSMS integration for Mailchimp marketing data, with templates, previewing, Unicode, long messages, personalisation tokens, smart tokens, and number formatting. - [Marketo](https://www.bulksms.com/products/integration-gateway/marketo-sms-integration.htm): Ready-built Marketo integration for marketing automation and sales lead generation workflows, with a quickstart guide. - [Monday.com](https://www.bulksms.com/products/integration-gateway/monday-sms-integration.htm): BulkSMS integration for Monday.com Work OS workflows, projects, and collaboration processes. - [My Gadget Repairs](https://www.bulksms.com/products/integration-gateway/mygadgetrepairs-sms-integration.htm): Native integration for repair-shop management workflows, such as supplier, staff, and repair-status communications. - [OrbisX](https://www.bulksms.com/products/integration-gateway/orbisx.htm): Native OrbisX integration for auto businesses, scheduling, invoicing, lead management, staff tracking, reminders, promotions, and repeat-business messaging. - [PRTG Network Monitor](https://www.paessler.com/): External native integration listed in the BulkSMS catalog for monitoring alerts and uptime workflows. - [Salesforce](https://www.bulksms.com/products/integration-gateway/salesforce-sms-integration.htm): BulkSMS App for Salesforce for contact, lead, and case workflows; supports individual SMS, two-way messaging, bulk sends to lists, delivery reports, activity history, templates, Unicode, long messages, and personalisation tokens. - [SME Professional](https://www.bulksms.com/products/integration-gateway/sme-professional-integration.htm): Native property-software integration for landlords, contractors, viewers, tenants, viewing confirmations, maintenance notifications, arrears, and property communications. - [SureTriggers](https://www.bulksms.com/products/integration-gateway/suretrigger-sms-integration.htm): SureTriggers app for connecting BulkSMS to automation workflows and other SaaS or WordPress tools; includes message sent and message received triggers. - [TurnKey Lender](https://www.bulksms.com/products/integration-gateway/turnkey-lender-sms-integration.htm): Native integration for AI-driven lending automation, borrower communications, loan lifecycle notifications, and decision-management workflows. - [WHMCS SMS Manager](https://marketplace.whmcs.com/product/5257-sms-manager-bulksms): External native integration listed in the catalog for WHMCS hosting, billing, and support workflows. - [Zapier](https://www.bulksms.com/products/integration-gateway/bulksms-app-for-zapier.htm): BulkSMS.com app on Zapier for connecting BulkSMS with thousands of apps; supports triggers such as message sent and message received and actions such as SMS sending. - [Shopify via Zapier](https://www.bulksms.com/products/integration-gateway/bulksms-zapier-and-shopify.htm): Zapier templates for SMS-enabling Shopify without custom code. - [Zoho](https://www.bulksms.com/products/integration-gateway/zoho-sms-integration.htm): BulkSMS Integration Gateway and native Zoho options for two-way and personalised messaging, submission and delivery reports, templates, Unicode, long messages, smart tokens, and number formatting. Help videos: https://www.bulksms.com/products/integration-gateway/zoho-sms-integration-help.htm ## Products And Feature Descriptions - [SMS API](https://www.bulksms.com/products/sms-api.htm): JSON REST API for programmatic SMS sending and receiving. Use for websites, applications, CRMs, automated alerts, OTPs, webhooks, Unicode, long messages, and SMS attachments. - [Web to SMS](https://www.bulksms.com/products/web-to-sms.htm): Browser-based BulkSMS web app for sending SMS, managing contacts, using advanced business messaging features, and sending from any internet-enabled device. - [BulkSMS Text Messenger](https://www.bulksms.com/products/bulksms-text-messenger.htm): Desktop app for ad hoc SMS campaigns from a PC, including contact and campaign management. - [Incoming Long Numbers](https://www.bulksms.com/products/incoming-long-numbers.htm): Dedicated virtual mobile numbers for receiving SMS directly into a BulkSMS account without exposing a personal phone number. Useful for text-in campaigns and customer replies. - [Premium Rated SMS Shortcodes](https://www.bulksms.com/products/premium-rated-sms.htm): Premium-rate shortcode services where customers pay to send an SMS to a shortcode; available as dedicated shortcodes or shared shortcode keywords. - [RCS Business Messaging](https://www.bulksms.com/products/rcs.htm): Rich Communications Services for branded, verified, interactive messages with media, cards, carousels, action buttons, and suggested replies. - [Two-Way SMS Messaging](https://www.bulksms.com/features/two-way-sms-messaging.htm): Repliable messaging so customers can respond directly and replies arrive in the BulkSMS account. Network reply support varies and should be tested. - [Sender ID](https://www.bulksms.com/features/sender-id.htm): Custom sender name or number shown in the message "from" field. Useful for brand recognition; recipients generally cannot reply to alpha Sender IDs, and some countries require Sender ID registration. - [Schedule SMS Messages](https://www.bulksms.com/features/schedule-sms-messages.htm): Schedule SMS sends for a future date and time, up to a year ahead. Useful for reminders, events, promotions, and out-of-office campaigns. - [Unicode SMS Messages](https://www.bulksms.com/features/unicode-sms-messages.htm): Send non-GSM characters and non-Latin scripts such as Arabic or messages with special symbols. Unicode changes character capacity and may require multiple SMS parts. - [Long SMS Messages](https://www.bulksms.com/features/long-sms-messages.htm): Concatenated long SMS support for messages longer than 160 GSM characters, delivered as a single message when supported by the recipient device and network. - [Personalised SMS Messages](https://www.bulksms.com/features/personalise-your-sms-messages.htm): Use contact fields or tokens to generate individualised messages at scale, such as name, appointment details, race numbers, payment amounts, or tenant details. - [SMS Attachments](https://www.bulksms.com/features/sms-attachments.htm): Add hosted documents, images, PDFs, JPEGs, or API-managed attachments to SMS by appending a URL to the message. - [SMS Landing Pages](https://www.bulksms.com/features/sms-landing-pages.htm): Create no-code mobile landing pages in the web app and attach them to outgoing SMS messages as links. - [Mobi-gram Messages](https://www.bulksms.com/features/mobi-gram-messages.htm): Add visual and interactive branded content to SMS campaigns, such as flyers, invitations, questionnaires, coupons, and race guides. - [Automatic SMS Responses](https://www.bulksms.com/features/automatic-responses.htm): Automatically reply when a customer sends an inbound SMS, supporting campaigns, lead capture, booking flows, and two-way automation. - [Automatic Opt-Out](https://www.bulksms.com/features/automatic-opt-out.htm): Automatically block contacts who reply with opt-out keywords such as STOP, UNSUBSCRIBE, or QUIT where replies are supported; link-based opt-out is available for non-repliable routes. - [Group Opt-In](https://www.bulksms.com/features/group-opt-in.htm): Let people add themselves to a BulkSMS contact group by texting a keyword to an incoming number. Recommended for testing before rollout outside South Africa and the United Kingdom. - [Email to SMS](https://www.bulksms.com/features/send-sms-messages-from-your-email.htm): Send and receive SMS from an email client without logging into BulkSMS. Useful when multiple staff need to send SMS or when a system can send email but does not have an API integration. - [Mobile to Group](https://www.bulksms.com/features/send-sms-messages-from-your-mobile-to-group.htm): Send an SMS from a mobile phone to a predefined BulkSMS contact group by including the group ID and sending to the relevant long number. - [Automatic Top-Up](https://www.bulksms.com/features/automatic-top-up.htm): Automatically buy SMS credits when account credits fall below a configured threshold. - [Low Credit Notification](https://www.bulksms.com/features/low-credit-notification.htm): Receive an SMS or email alert when the SMS credit balance reaches a configured low threshold. - [Transfer SMS Credits](https://www.bulksms.com/features/transfer-sms-credits.htm): Transfer credits from one BulkSMS account to another for reseller, enterprise, or departmental account management. - [Sponsor SMS Credits](https://www.bulksms.com/features/sponsor-sms-credits.htm): Allocate a predetermined number of SMS credits monthly from a main account to linked accounts. - [SMS Reseller](https://www.bulksms.com/features/sms-reseller.htm): Buy SMS credits in bulk and resell smaller batches to customers. BulkSMS does not set the reseller's onward pricing. - [SMS Routing Options](https://www.bulksms.com/pricing/sms-routing.htm): Economy, Standard, and Premium routing options. Standard is the default and recommended route; Economy prioritises low cost; Premium prioritises delivery and reliability. ## OpenAPI Spec Reference The full OpenAPI YAML is at https://www.bulksms.com/developer/json/v1/openapi.yaml. It is approximately 1,900 lines, so this file references it rather than embedding the whole spec. Important API facts for LLMs: - OpenAPI title: BulkSMS JSON REST API. - OpenAPI version: 1.1.0. - Production server: `https://api.bulksms.com/v1`. - Authentication: HTTP Basic Auth using an API token ID as username and API token secret as password. - Content type: JSON request and response bodies use `application/json`. - Main tags: Authentication, Message, Profile, Webhooks, Credits, Blocked Numbers, Attachments. - Main paths: `/messages`, `/messages/{id}`, `/messages/{id}/relatedReceivedMessages`, `/messages/send`, `/profile`, `/webhooks`, `/webhooks/{id}`, `/blocked-numbers`, `/credit/transfer`, `/rmm/pre-sign-attachment`. - Main operations: retrieve messages, send messages, show a message, list related received messages, send by simple GET or POST, get profile, list/create/read/update/delete webhooks, list/create blocked numbers, transfer credits, and upload an attachment via a signed URL. Do not treat `downloads/BulkSMS-GWPF0001.swagger.json` as the full public API spec. It is a smaller Swagger 2.0 export for PowerAutomate and only covers sending an SMS through `/v1/messages`. ## Country Coverage Use the country JSON endpoint for the current list. The full country list currently returns the following 233 country links. The pricing-estimate list with `exclNoAverageRg2Pricing=1` returns a smaller set because it omits countries without average route 2 pricing. - [Afghanistan](https://www.bulksms.com/countries/a/afghanistan) - [Albania](https://www.bulksms.com/countries/a/albania) - [Algeria](https://www.bulksms.com/countries/a/algeria) - [Andorra](https://www.bulksms.com/countries/a/andorra) - [Angola](https://www.bulksms.com/countries/a/angola) - [Anguilla](https://www.bulksms.com/countries/a/anguilla) - [Antigua & Barbuda](https://www.bulksms.com/countries/a/antigua---barbuda) - [Argentina](https://www.bulksms.com/countries/a/argentina) - [Armenia](https://www.bulksms.com/countries/a/armenia) - [Aruba](https://www.bulksms.com/countries/a/aruba) - [Australia](https://www.bulksms.com/countries/a/australia) - [Austria](https://www.bulksms.com/countries/a/austria) - [Azerbaijan](https://www.bulksms.com/countries/a/azerbaijan) - [Bahamas](https://www.bulksms.com/countries/b/bahamas) - [Bahrain](https://www.bulksms.com/countries/b/bahrain) - [Bangladesh](https://www.bulksms.com/countries/b/bangladesh) - [Barbados](https://www.bulksms.com/countries/b/barbados) - [Belarus](https://www.bulksms.com/countries/b/belarus) - [Belgium](https://www.bulksms.com/countries/b/belgium) - [Belize](https://www.bulksms.com/countries/b/belize) - [Benin](https://www.bulksms.com/countries/b/benin) - [Bermuda](https://www.bulksms.com/countries/b/bermuda) - [Bhutan](https://www.bulksms.com/countries/b/bhutan) - [Bolivia](https://www.bulksms.com/countries/b/bolivia) - [Bosnia-Herzegovina](https://www.bulksms.com/countries/b/bosnia-herzegovina) - [Botswana](https://www.bulksms.com/countries/b/botswana) - [Brazil](https://www.bulksms.com/countries/b/brazil) - [Brunei](https://www.bulksms.com/countries/b/brunei) - [Bulgaria](https://www.bulksms.com/countries/b/bulgaria) - [Burkina Faso](https://www.bulksms.com/countries/b/burkina-faso) - [Burundi](https://www.bulksms.com/countries/b/burundi) - [Cambodia](https://www.bulksms.com/countries/c/cambodia) - [Cameroon](https://www.bulksms.com/countries/c/cameroon) - [Canada](https://www.bulksms.com/countries/c/canada) - [Cape Verde Islands](https://www.bulksms.com/countries/c/cape-verde-islands) - [Caribbean Antilles and Curacao](https://www.bulksms.com/countries/c/caribbean-antilles-and-cura--ao) - [Cayman Islands](https://www.bulksms.com/countries/c/cayman-islands) - [Central African Republic](https://www.bulksms.com/countries/c/central-african-republic) - [Chad](https://www.bulksms.com/countries/c/chad) - [Chile](https://www.bulksms.com/countries/c/chile) - [China](https://www.bulksms.com/countries/c/china) - [Colombia](https://www.bulksms.com/countries/c/colombia) - [Comoros](https://www.bulksms.com/countries/c/comoros) - [Congo](https://www.bulksms.com/countries/c/congo) - [Congo, Democratic Republic](https://www.bulksms.com/countries/c/congo--democratic-republic) - [Cook Islands](https://www.bulksms.com/countries/c/cook-islands) - [Costa Rica](https://www.bulksms.com/countries/c/costa-rica) - [Croatia](https://www.bulksms.com/countries/c/croatia) - [Cyprus](https://www.bulksms.com/countries/c/cyprus) - [Czech Republic](https://www.bulksms.com/countries/c/czech-republic) - [Denmark](https://www.bulksms.com/countries/d/denmark) - [Diego Garcia](https://www.bulksms.com/countries/d/diego-garcia) - [Djibouti](https://www.bulksms.com/countries/d/djibouti) - [Dominica](https://www.bulksms.com/countries/d/dominica) - [Dominican Republic](https://www.bulksms.com/countries/d/dominican-republic) - [Dominican Republic2](https://www.bulksms.com/countries/d/dominican-republic2) - [Dominican Republic3](https://www.bulksms.com/countries/d/dominican-republic3) - [Ecuador](https://www.bulksms.com/countries/e/ecuador) - [Egypt](https://www.bulksms.com/countries/e/egypt) - [El Salvador](https://www.bulksms.com/countries/e/el-salvador) - [Equatorial Guinea](https://www.bulksms.com/countries/e/equatorial-guinea) - [Eritrea](https://www.bulksms.com/countries/e/eritrea) - [Estonia](https://www.bulksms.com/countries/e/estonia) - [Ethiopia](https://www.bulksms.com/countries/e/ethiopia) - [Falkland Islands](https://www.bulksms.com/countries/f/falkland-islands) - [Faroe Islands](https://www.bulksms.com/countries/f/faroe-islands) - [Fiji Islands](https://www.bulksms.com/countries/f/fiji-islands) - [Finland](https://www.bulksms.com/countries/f/finland) - [France](https://www.bulksms.com/countries/f/france) - [French Guiana](https://www.bulksms.com/countries/f/french-guiana) - [French Polynesia](https://www.bulksms.com/countries/f/french-polynesia) - [Gabon](https://www.bulksms.com/countries/g/gabon) - [Gambia](https://www.bulksms.com/countries/g/gambia) - [Georgia](https://www.bulksms.com/countries/g/georgia) - [Germany](https://www.bulksms.com/countries/g/germany) - [Ghana](https://www.bulksms.com/countries/g/ghana) - [Gibraltar](https://www.bulksms.com/countries/g/gibraltar) - [Greece](https://www.bulksms.com/countries/g/greece) - [Greenland](https://www.bulksms.com/countries/g/greenland) - [Grenada](https://www.bulksms.com/countries/g/grenada) - [Guadeloupe](https://www.bulksms.com/countries/g/guadeloupe) - [Guam](https://www.bulksms.com/countries/g/guam) - [Guatemala](https://www.bulksms.com/countries/g/guatemala) - [Guernsey](https://www.bulksms.com/countries/g/guernsey) - [Guinea](https://www.bulksms.com/countries/g/guinea) - [Guinea-Bissau](https://www.bulksms.com/countries/g/guinea-bissau) - [Guyana](https://www.bulksms.com/countries/g/guyana) - [Haiti](https://www.bulksms.com/countries/h/haiti) - [Honduras](https://www.bulksms.com/countries/h/honduras) - [HongKong](https://www.bulksms.com/countries/h/hongkong) - [Hungary](https://www.bulksms.com/countries/h/hungary) - [Iceland](https://www.bulksms.com/countries/i/iceland) - [India](https://www.bulksms.com/countries/i/india) - [Indonesia](https://www.bulksms.com/countries/i/indonesia) - [International (Satellite phones and similar)](https://www.bulksms.com/countries/i/international--satellite-phones-and-similar-) - [International 1](https://www.bulksms.com/countries/i/international-1) - [International 2](https://www.bulksms.com/countries/i/international-2) - [International 3](https://www.bulksms.com/countries/i/international-3) - [International 4](https://www.bulksms.com/countries/i/international-4) - [International 5](https://www.bulksms.com/countries/i/international-5) - [International 6](https://www.bulksms.com/countries/i/international-6) - [International 7](https://www.bulksms.com/countries/i/international-7) - [Iraq](https://www.bulksms.com/countries/i/iraq) - [Ireland](https://www.bulksms.com/countries/i/ireland) - [Isle of Man](https://www.bulksms.com/countries/i/isle-of-man) - [Israel](https://www.bulksms.com/countries/i/israel) - [Italy](https://www.bulksms.com/countries/i/italy) - [Ivory Coast](https://www.bulksms.com/countries/i/ivory-coast) - [Jamaica](https://www.bulksms.com/countries/j/jamaica) - [Japan](https://www.bulksms.com/countries/j/japan) - [Jersey](https://www.bulksms.com/countries/j/jersey) - [Jordan](https://www.bulksms.com/countries/j/jordan) - [Kazakhstan](https://www.bulksms.com/countries/k/kazakhstan) - [Kenya](https://www.bulksms.com/countries/k/kenya) - [Korea (South)](https://www.bulksms.com/countries/k/korea--south-) - [Kosovo](https://www.bulksms.com/countries/k/kosovo) - [Kuwait](https://www.bulksms.com/countries/k/kuwait) - [Kyrgyzstan](https://www.bulksms.com/countries/k/kyrgyzstan) - [Laos](https://www.bulksms.com/countries/l/laos) - [Latvia](https://www.bulksms.com/countries/l/latvia) - [Lebanon](https://www.bulksms.com/countries/l/lebanon) - [Lesotho](https://www.bulksms.com/countries/l/lesotho) - [Liberia](https://www.bulksms.com/countries/l/liberia) - [Libya](https://www.bulksms.com/countries/l/libya) - [Liechtenstein](https://www.bulksms.com/countries/l/liechtenstein) - [Lithuania](https://www.bulksms.com/countries/l/lithuania) - [Luxembourg](https://www.bulksms.com/countries/l/luxembourg) - [Macau](https://www.bulksms.com/countries/m/macau) - [Macedonia](https://www.bulksms.com/countries/m/macedonia) - [Madagascar](https://www.bulksms.com/countries/m/madagascar) - [Malawi](https://www.bulksms.com/countries/m/malawi) - [Malaysia](https://www.bulksms.com/countries/m/malaysia) - [Maldives](https://www.bulksms.com/countries/m/maldives) - [Mali Republic](https://www.bulksms.com/countries/m/mali-republic) - [Malta](https://www.bulksms.com/countries/m/malta) - [Martinique](https://www.bulksms.com/countries/m/martinique) - [Mauritania](https://www.bulksms.com/countries/m/mauritania) - [Mauritius](https://www.bulksms.com/countries/m/mauritius) - [Mayotte Island](https://www.bulksms.com/countries/m/mayotte-island) - [Mexico](https://www.bulksms.com/countries/m/mexico) - [Moldova](https://www.bulksms.com/countries/m/moldova) - [Monaco](https://www.bulksms.com/countries/m/monaco) - [Mongolia](https://www.bulksms.com/countries/m/mongolia) - [Montenegro](https://www.bulksms.com/countries/m/montenegro) - [Montserrat](https://www.bulksms.com/countries/m/montserrat) - [Morocco](https://www.bulksms.com/countries/m/morocco) - [Mozambique](https://www.bulksms.com/countries/m/mozambique) - [Myanmar](https://www.bulksms.com/countries/m/myanmar) - [Namibia](https://www.bulksms.com/countries/n/namibia) - [Nauru](https://www.bulksms.com/countries/n/nauru) - [Nepal](https://www.bulksms.com/countries/n/nepal) - [Netherlands](https://www.bulksms.com/countries/n/netherlands) - [New Caledonia](https://www.bulksms.com/countries/n/new-caledonia) - [New Zealand](https://www.bulksms.com/countries/n/new-zealand) - [Nicaragua](https://www.bulksms.com/countries/n/nicaragua) - [Niger](https://www.bulksms.com/countries/n/niger) - [Nigeria](https://www.bulksms.com/countries/n/nigeria) - [Niue](https://www.bulksms.com/countries/n/niue) - [Norfolk Island](https://www.bulksms.com/countries/n/norfolk-island) - [Norway](https://www.bulksms.com/countries/n/norway) - [Oman](https://www.bulksms.com/countries/o/oman) - [Pakistan](https://www.bulksms.com/countries/p/pakistan) - [Palestine](https://www.bulksms.com/countries/p/palestine) - [Panama](https://www.bulksms.com/countries/p/panama) - [Papua New Guinea](https://www.bulksms.com/countries/p/papua-new-guinea) - [Paraguay](https://www.bulksms.com/countries/p/paraguay) - [Peru](https://www.bulksms.com/countries/p/peru) - [Philippines](https://www.bulksms.com/countries/p/philippines) - [Poland](https://www.bulksms.com/countries/p/poland) - [Portugal](https://www.bulksms.com/countries/p/portugal) - [Puerto Rico](https://www.bulksms.com/countries/p/puerto-rico) - [Qatar](https://www.bulksms.com/countries/q/qatar) - [Reunion](https://www.bulksms.com/countries/r/reunion) - [Romania](https://www.bulksms.com/countries/r/romania) - [Rwanda](https://www.bulksms.com/countries/r/rwanda) - [Saint Helena and Tristan da Cunha](https://www.bulksms.com/countries/s/saint-helena-and-tristan-da-cunha) - [Saint Kitts and Nevis](https://www.bulksms.com/countries/s/saint-kitts-and-nevis) - [Saint Lucia](https://www.bulksms.com/countries/s/saint-lucia) - [Saint Pierre and Miquelon](https://www.bulksms.com/countries/s/saint-pierre-and-miquelon) - [Samoa](https://www.bulksms.com/countries/s/samoa) - [San Marino](https://www.bulksms.com/countries/s/san-marino) - [Sao Tome and Principe](https://www.bulksms.com/countries/s/sao-tome-and-principe) - [Saudi Arabia](https://www.bulksms.com/countries/s/saudi-arabia) - [Senegal](https://www.bulksms.com/countries/s/senegal) - [Serbia](https://www.bulksms.com/countries/s/serbia) - [Seychelles](https://www.bulksms.com/countries/s/seychelles) - [Sierra Leone](https://www.bulksms.com/countries/s/sierra-leone) - [Singapore](https://www.bulksms.com/countries/s/singapore) - [Sint Maarten (Dutch)](https://www.bulksms.com/countries/s/sint-maarten--dutch-) - [Slovakia](https://www.bulksms.com/countries/s/slovakia) - [Slovenia](https://www.bulksms.com/countries/s/slovenia) - [Solomon Islands](https://www.bulksms.com/countries/s/solomon-islands) - [Somalia](https://www.bulksms.com/countries/s/somalia) - [South Africa](https://www.bulksms.com/countries/s/south-africa) - [South Sudan](https://www.bulksms.com/countries/s/south-sudan) - [Spain](https://www.bulksms.com/countries/s/spain) - [Sri Lanka](https://www.bulksms.com/countries/s/sri-lanka) - [St. Vincent and The Grenadines](https://www.bulksms.com/countries/s/st--vincent-and-the-grenadines) - [Sudan](https://www.bulksms.com/countries/s/sudan) - [Suriname](https://www.bulksms.com/countries/s/suriname) - [Swaziland](https://www.bulksms.com/countries/s/swaziland) - [Sweden](https://www.bulksms.com/countries/s/sweden) - [Switzerland](https://www.bulksms.com/countries/s/switzerland) - [Taiwan](https://www.bulksms.com/countries/t/taiwan) - [Tajikistan](https://www.bulksms.com/countries/t/tajikistan) - [Tanzania](https://www.bulksms.com/countries/t/tanzania) - [Thailand](https://www.bulksms.com/countries/t/thailand) - [Timor-Leste](https://www.bulksms.com/countries/t/timor-leste) - [Togo](https://www.bulksms.com/countries/t/togo) - [Tonga](https://www.bulksms.com/countries/t/tonga) - [Trinidad and Tobago](https://www.bulksms.com/countries/t/trinidad-and-tobago) - [Tunisia](https://www.bulksms.com/countries/t/tunisia) - [Turkey](https://www.bulksms.com/countries/t/turkey) - [Turkmenistan](https://www.bulksms.com/countries/t/turkmenistan) - [Turks and Caicos Islands](https://www.bulksms.com/countries/t/turks-and-caicos-islands) - [Tuvalu](https://www.bulksms.com/countries/t/tuvalu) - [Uganda](https://www.bulksms.com/countries/u/uganda) - [Ukraine](https://www.bulksms.com/countries/u/ukraine) - [United Arab Emirates](https://www.bulksms.com/countries/u/united-arab-emirates) - [United Kingdom](https://www.bulksms.com/countries/u/united-kingdom) - [United States of America](https://www.bulksms.com/countries/u/united-states-of-america) - [Uruguay](https://www.bulksms.com/countries/u/uruguay) - [Uzbekistan](https://www.bulksms.com/countries/u/uzbekistan) - [Vanuatu](https://www.bulksms.com/countries/v/vanuatu) - [Venezuela](https://www.bulksms.com/countries/v/venezuela) - [Vietnam](https://www.bulksms.com/countries/v/vietnam) - [Virgin Islands, British](https://www.bulksms.com/countries/v/virgin-islands--british) - [Virgin Islands, US](https://www.bulksms.com/countries/v/virgin-islands--us) - [Wallis and Futuna](https://www.bulksms.com/countries/w/wallis-and-futuna) - [Worldwide](https://www.bulksms.com/countries/w/worldwide) - [Yemen](https://www.bulksms.com/countries/y/yemen) - [Zambia](https://www.bulksms.com/countries/z/zambia) - [Zimbabwe](https://www.bulksms.com/countries/z/zimbabwe)