Response codes and headers

HTTP statuses, eCall result codes, request IDs, and source IPs.

Response types

The interface returns two response types:

• Send methods return HTTP status codes and eCall result codes.

• Cache operations return eCall result codes in the response body.

HTTP status codes

Status Code	Status Text	Description
200	OK	Job was accepted successfully
400	BadRequest	Request failed. Check the eCall result code
401	Unauthorized	Credentials are missing or invalid
403	Forbidden	The account has insufficient credits
500	InternalServerError	General processing error

Cache queries return HTTP 200 OK. Check the XML body for the actual result code.

eCall result codes

Code	ResponseText	Description
0	OK	Message submitted successfully
11000	SyntaxError	Syntax error
11001	PermissionDenied	Access denied
11100	AdrAdCInvalid	Invalid recipient address
11101	AdrNAdInvalid	Invalid notification address
11102	AdrAdCMissing	Missing recipient address
11103	AdrNAdMissing	Missing notification address
11104	AdrAdCTooMany	Too many recipient addresses
11105	AdrAdCNotAllowed	Recipient address is outside the allowed range
11106	AdrCountryNotWhitelisted	Destination country not whitelisted for this account
11107	AdrCountryWhitelistLimitExceeded	Daily limit for destination country exceeded (country is blocked)
11108	AdrCountryWhitelistLimitReachedButNotBlockedCountries	More than one receiver: Daily limit for at least one destination country would be exceeded (countries are not blocked)
11200	MsgNoCharacters	Missing message content
11201	MsgInvalidCharacters	Invalid characters in the message
11202	MsgSendTimeInvalid	Invalid send time
11203	MsgSendTimeNotAllowed	Send time is outside the allowed time window
11204	MsgTooLong	SMS or pager message is too long
11300	AccNoUser	Unknown user
11301	AccNoUnits	Insufficient credits
11303	AccNoFreeUnits	Insufficient free credits
11400	CallSystemInvalid	Invalid alerting system
11401	CallSystemInvalidForUser	Invalid alerting system for this user
11402	CallSystemNotSupported	Alerting system is not supported
11403	CallSystemConfused	Alerting system is temporarily unavailable
11500	IDMissing	Missing ID
11501	IDInvalid	ID could not be found
11502	IDDoesNotExist	ID does not exist
11600	StateAlreadyTransmitted	Message was already sent
11700	DataReadError	Data content could not be read
11800	CBMsgError	Callback contains a forbidden number or text
11810	AnswerInvalid	Answer contains an invalid address
11904	Too many attachments	More than 10 attachments were sent
11905	Attachment(s) too large	At least one attachment exceeds 5 MB
11906	File type not supported	Unsupported file type
11907	Error while processing the attachments	Unexpected attachment processing error
11908	Error while saving the attachments	Unexpected attachment save error
11910	Job not found in Log	Job could not be found in the log
11911	JobID required	A JobID is required for status queries
11912	Job is scheduled	Job is scheduled for a future time
11913	Job in progress	Job is still being processed
11914	Attachment name exceedes char limit	Attachment name exceeds the character limit
11999	Unknown error	Unknown error

Client request ID

Set this request header to correlate responses with your own request IDs:

x-f24-client-request-id

Maximum length: 100 characters.

If you set it, the service echoes the same value in the response.

Server request ID

Every response includes this header:

x-f24-request-id

Provide this value to support together with:

• The request time

• The eCall account name or interface username

• The operation type

Source IP addresses

Use these source IPs to allow inbound traffic from eCall to your service:

• 193.93.208.200

• 193.93.208.149

• 193.93.208.153

Source ports are dynamic and can use the full range 0–65535.