Receive Free SMS API

Welcome to the official Developer API for Receive Free SMS. Our RESTful API allows you to programmatically fetch public numbers, read incoming SMS messages, and manage your private rented numbers.

Base URL

All API requests should be made to the following base URL:

https://receivefreesms.co.uk/developer/v1

Authentication

The API uses Bearer Token authentication via Laravel Sanctum. You must include your API Key in the Authorization header of every request.

Authorization: Bearer YOUR_API_KEY_HERE

Generating an API Key

You can generate, rotate, or revoke your API keys directly from your user dashboard at /dashboard.

Rate Limiting

To ensure platform stability, all API requests are subject to strict rate limits. Our API employs a tri-tier rate limiting system based on your user account:

Per Minute: Default 60 requests / minute
Per Day: Default 5,000 requests / day
Per Month: Default 100,000 requests / month

If you exceed any of these limits, you will receive a 429 Too Many Requests HTTP response.

Standard Error Response

When an error occurs, the API returns a standardized JSON response:

{
  "success": false,
  "message": "Detailed error message here.",
  "error_code": "ERROR_CODE_IDENTIFIER"
}

Common Error Codes:

API_DISABLED: The Developer API is globally turned off.
UNAUTHENTICATED: Missing, invalid, or revoked API key.
ACCOUNT_SUSPENDED: Your account has been banned.
API_PUBLIC_ACCESS_DENIED: You lack permission to query public endpoints.
API_PRIVATE_ACCESS_DENIED: You lack permission to query private endpoints.

Endpoints Overview

Account: Check your API status and limits.
Public Numbers: Fetch active countries, numbers, and read public messages.
Private Numbers: Fetch and manage messages for numbers you have exclusively rented.

Last updated: