Private Numbers API

These endpoints allow you to access phone numbers that you have exclusively rented via the marketplace. Only you can view the messages sent to these numbers.

Note: You can only query numbers that belong to your account ID.

1. List My Rented Numbers

Returns a list of all private numbers currently rented by your account.

Endpoint: GET /my-numbers

Example Request:

curl -X GET "https://receivefreesms.co.uk/developer/v1/my-numbers" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

2. Get Private Number Details

Retrieve details about a specific private number you are renting, including expiration time.

Endpoint: GET /my-numbers/{number}

Path Parameters:

• number: The exact phone number string.

Example Request:

curl -X GET "https://receivefreesms.co.uk/developer/v1/my-numbers/1234567890" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

3. Read Private Messages

Fetch the private SMS messages sent exclusively to your rented number.

Endpoint: GET /my-numbers/{number}/messages

Path Parameters:

• number: The exact phone number string.

Query Parameters:

• page (optional): For pagination of older messages.

Example Request:

curl -X GET "https://receivefreesms.co.uk/developer/v1/my-numbers/1234567890/messages" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"