---
title: "Check message price"
method: GET
path: "/api/v2/messages/price/normalized"
tags: ["Outbound Messages"]
---

# Check message price

`GET /api/v2/messages/price/normalized`

<a class="try-sandbox-link" href="https://sandbox.textmagic.com/#/Messages%3A%20Send%0A/getMessagePrice" target="_blank">Try in sandbox</a><br>Check pricing for a new outbound message.

## Query parameters

- `includeBlocked` 0 | 1
- `text` string
- `templateId` integer
- `sendingTime` integer
- `sendingDateTime` string
- `sendingTimezone` string
- `contacts` string
- `lists` string
- `phones` string
- `cutExtra` 0 | 1
- `partsCount` integer
- `referenceId` integer
- `from` string
- `rule` string
- `createChat` 0 | 1
- `tts` 0 | 1
- `local` 0 | 1
- `localCountry` string

## Response `200`

Returned when successful.

- GetMessagePriceResponse
  - `total` number, required — Total price of the message.
  - `parts` integer, nullable, required — Message parts (multiples of 160 characters) count.
  - `countries` GetMessagePriceResponseCountriesItem[], required
    - `country` string, required — The 2-letter ISO country code.
    - `countryName` string, required — Country name.
    - `allowDedicated` boolean, required — Is allowed to use a dedicated number?
    - `count` number, required — Parts count to send.
    - `max` number, required — Maximum parts to send.
    - `sum` string, required — Total price to send.
    - `landline` number, required — Is this a landline number?

## Other responses

- `400` — Bad request.
- `401` — Unauthorized request.

---

[API](https://skmtc.net/textmagic/apis/textmagic-api.md) · [All operations](https://skmtc.net/textmagic/apis/textmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/textmagic/textmagic-api/revisions/3e4029d19684/schema)