Request / Response Headers

Learn which headers are used in MTA API calls and responses.

Request Headers

Request headers contain information about the client request. Learn more about the header types used by the Mobile Text Alerts API.

Authorization

The Authorization header is used for authentication purposes in HTTP requests. This is a token or credentials used to prove the client's identity. The Mobile Text Alerts API uses Bearer Token Authentication with an API Key.

Header structure: "Authorization: Bearer {myAPIKey}"

Example request:

curl -L \
  -H 'Authorization: Bearer 89fa747a-e01b-5940-99c2-4e96fa996258' \
  'https://api.mobile-text-alerts.com/v3/auth/verify-api-key'// 

See Get an API Key to learn how to generate and send this key in a request.

Content-Type

Content-Type is an HTTP header that indicates the data type of the request’s message body. This is needed for the server to understand how to process the request data.

Header structure: "Content-Type: application/json"

Example request:

curl --location 'https://api.mobile-text-alerts.com/v3/groups/12345/subscribers/bulk-create' \
--header 'Content-Type: application/json' \
--data '{
    "subscriberIds": [
        123
    ]
}'

Response Headers

Response headers provide metadata about the response to the client. Most of the MTA API response headers provide information about your individual account's rate limit usage.

Parameter	Type	Description
RateLimit-Limit	integer	The maximum number of requests that the consumer is permitted to make per window.
RateLimit-Remaining	integer	The number of requests remaining in the current rate limit window.
RateLimit-Reset	integer	The remaining window before the rate limit resets (in milliseconds).
Retry-After	integer	The number of seconds to wait before retrying the request.
X-RateLimit-Limit	integer	The maximum number of requests that the consumer is permitted to make per window.
X-RateLimit-Remaining	integer	The number of requests remaining in the current rate limit window.
X-RateLimit-Reset	integer	The remaining window before the rate limit resets (in milliseconds).
X-Request-ID	string	A unique identifier for the request.