Skip to main content

Phonebook API

Phonebook API enables you to use our blacklisting feature to make sure you're not sending any unwanted messages.


API Setup

API requests are made to the following server:

https://api.messente.com/

Authentication and making requests

Requests are done with JSON body and HTTP Basic Auth is used for authentication.

Request headers example

Accept: application/json
Content-Type: application/json
Authentication: Basic QWxhZGRpbjpPcGVuU2VzYW1l

Error handling

If the request fails, the API will return an error response with a status code and an error message. The error message will provide details about what went wrong, such as invalid parameters or authentication issues.

{
"errors": [
{
"code": "202",
"detail": "User e9fbc8a9a9845 does not exist",
"title": "Unauthorized"
}
]
}

You can use the following status codes to handle errors:

HTTP response codeError codeDescription
400
201
Missing required parameter
401
202
Authentication error
404
203
Missing resource error
409
204
Duplicate object detected
other 4xx
244
Client error
500
205
General error