> For the complete documentation index, see [llms.txt](https://docs.sms4sats.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sms4sats.com/api-reference/get-price.md).

# Get Price

<mark style="color:blue;">`GET`</mark> `https://api2.sms4sats.com/price`

Returns pricing in satoshis for receive, send, and rental operations. Optionally pass a country and service to get the exact computed price for that combination.

#### Query Parameters

| Name      | Type             | Required | Description                                                     |
| --------- | ---------------- | -------- | --------------------------------------------------------------- |
| `country` | Number or String | No       | ISO country name or numeric country code (e.g. `"us"` or `187`) |
| `service` | String           | No       | Short or long service name (e.g. `"google"`, `"tg"`, `"ot"`)    |

{% tabs %}
{% tab title="200: OK" %}

```javascript
{
    "receive": "1500",
    "send": 3000,
    "rent": 15000,
    "s4s": "4000",
    "query": {
        "country": "us",
        "service": "google"
    },
    "computed": {
        "price": 1500,
        "country": 187,
        "description": "sms4sats payment US google"
    }
}
```

{% endtab %}
{% endtabs %}

### Response Fields

| Field                  | Type   | Description                                            |
| ---------------------- | ------ | ------------------------------------------------------ |
| `receive`              | String | Price to receive an SMS activation code (satoshis)     |
| `send`                 | Number | Price to send an SMS message (satoshis)                |
| `rent`                 | Number | Price to rent a phone number (satoshis)                |
| `s4s`                  | String | Platform fee (satoshis)                                |
| `computed.price`       | Number | Exact price for the queried country/service (satoshis) |
| `computed.country`     | Number | Resolved numeric country code                          |
| `computed.description` | String | Human-readable description of the computed order       |

{% hint style="info" %}
Omit `country` and `service` to get generic min/max price ranges. Pass both for an exact price for a specific country/service combination.
{% endhint %}