PHPackages                             ahmedghanem00/tempnumber-api-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. ahmedghanem00/tempnumber-api-client

ActiveLibrary[API Development](/categories/api)

ahmedghanem00/tempnumber-api-client
===================================

An API client for Temp-Number service ( https://temp-number.org/ )

1.1.10(1y ago)4341MITPHPPHP ^8.2

Since Apr 28Pushed 1y ago1 watchersCompare

[ Source](https://github.com/ahmedghanem00/tempnumber-api-client)[ Packagist](https://packagist.org/packages/ahmedghanem00/tempnumber-api-client)[ RSS](/packages/ahmedghanem00-tempnumber-api-client/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (4)Dependencies (5)Versions (6)Used By (0)

TempNumber Api Client
=====================

[](#tempnumber-api-client)

An API client for Temp-Number service (  ) written in PHP.

If you encounter a bug or have an idea to improve the code, feel free to open an issue or submit a pull request.

Installation
------------

[](#installation)

```
$ composer require ahmedghanem00/tempnumber-api-client

```

Usage
-----

[](#usage)

#### Client Initialization :

[](#client-initialization-)

```
use ahmedghanem00\TempNumberClient\Client;

$client = new Client('YOUR_API_TOKEN');
```

#### Retrieve Balance :

[](#retrieve-balance-)

```
try {
    echo $client->retrieveBalance(); // float "3.15"
} catch (Exception $e) {
    echo $e->getMessage();
}
```

#### Requesting new activation :

[](#requesting-new-activation-)

```
use ahmedghanem00\TempNumberClient\Enum\Country;
use ahmedghanem00\TempNumberClient\Enum\Service;

try {
    # You can either use Service & Country enums as arguments or use the ids directly ( 'facebook', 'us' )
    # If the activation price is higher than the given expected, the 'ExpectedPriceException' will be thrown
    $newActivation = $client->requestNewActivation(Service::Facebook, Country::United_States, $expectedPrice = 2.5);

    [$countryCode, $numberOnly, $formattedPhoneNumberWithCountryCode] = [
        $newActivation->getPhoneNumberCountryCode(),
        $newActivation->getPhoneNumberWithoutCountryCode(),
        $newActivation->getFormattedPhoneNumberWithCountryCode()
    ];

    # Will continuously polling the activation data from server until the specified condition is met.
    # Otherwise, the appropriate exception will be thrown
    $fulfilledActivationWithSmsMessage = $client->waitForActivationStatus($newActivation->getId(), ActivationStatus::SMS_RECEIVED, $pollingInterval = 2, $maxDuration = 100);

    echo $fulfilledActivationWithSmsMessage->getReceivedSMS(); ## "Thanks for activation. Your activation code is: 5678"
    echo $fulfilledActivationWithSmsMessage->getDetectedOtpCodeFromReceivedSMS(); ## "5678"
} catch (Exception $e) {
    echo $e->getMessage();
}
```

#### Retry Activation :

[](#retry-activation-)

In case you have specific activation that needs to be retried

```
try {
    $client->retryActivation(181822);
} catch (Exception $e) {
    echo $e->getMessage();
}
```

#### Retrieve specific activation data :

[](#retrieve-specific-activation-data-)

```
try {
    $activationData = $client->retrieveActivationData(181822);

    echo $activationData->getStatus(); // string "smsRequested"
    echo $activationData->getCreationTimestamp(); // int "1681333257"
    echo $activationData->getRemainingSecondsToExpire(); // int "300"
    echo $activationData->isRetryable(); // bool "false"
    echo $activationData->getPhoneNumberWithoutCountryCode(); // string "(555) 555-1234"
catch (Exception $e) {
    echo $e->getMessage();
}
```

#### Retrieve specific Service & country Info :

[](#retrieve-specific-service--country-info-)

```
use ahmedghanem00\TempNumberClient\Enum\Country;
use ahmedghanem00\TempNumberClient\Enum\Service;

try {
    $info = $client->retrieveCountryServiceInfo(Service::Instagram, Country::Russia)

    echo $info->hasNumbers(); // bool "true"
    echo $info->getPrice(); // float "2.15"
} catch (Exception $e) {
    echo $e->getMessage();
}
```

#### Retrieve all services/countries info :

[](#retrieve-all-servicescountries-info-)

```
# Grouped by service
$infoGroupedByService = $client->retrievePriceListByService();

# OR by country
$infoGroupedByCountry = $client->retrievePriceListByCountry();

foreach ($infoGroupedByCountry as $country) {
    echo $country->getName(); // 'uk'

    foreach ($country->services() as $countryService) {
        echo $countryService->getName(); // string "facebook"
        echo $countryService->getPrice(); // float "1.25"
    }
}
```

#### Retrieve all previous activations data :

[](#retrieve-all-previous-activations-data-)

```
$result = $client->retrieveActivationHistory($page = 2, $limit = 5);

echo $result->getPageIndex(); // 2
echo $result->getPagesCount(); // 30
echo $result->getActivationsCount(); // 200

foreach ($result->activations() as $activation) {
    echo $activation->getId();
    echo $activation->getStatus();
    echo $activation->getPrice();
    echo $activation->getFormattedPhoneNumberWithCountryCode();
    echo $activation->getReceivedSMS();
}
```

LICENSE
-------

[](#license)

Package is licensed under the [MIT License](http://opensource.org/licenses/MIT).

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance32

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity61

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~128 days

Total

4

Last Release

722d ago

PHP version history (2 changes)1.0.0PHP >=8.2

1.1.10PHP ^8.2

### Community

Maintainers

![](https://www.gravatar.com/avatar/41ca670c714d793e5dd90b8473db6af39b137d3c863883b081c0ea4426d8d671?d=identicon)[ahmedghanem00](/maintainers/ahmedghanem00)

---

Top Contributors

[![ahmedghanem00](https://avatars.githubusercontent.com/u/124502255?v=4)](https://github.com/ahmedghanem00 "ahmedghanem00 (28 commits)")

---

Tags

api-clientapi-client-phpdisposable-phone-numberphptemporary-phone-numberapi clienttemporary phone numberdisposable phone number

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/ahmedghanem00-tempnumber-api-client/health.svg)

```
[![Health](https://phpackages.com/badges/ahmedghanem00-tempnumber-api-client/health.svg)](https://phpackages.com/packages/ahmedghanem00-tempnumber-api-client)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M648](/packages/sylius-sylius)[smsapi/php-client

SMSAPI API PHP Client

652.1M17](/packages/smsapi-php-client)[crowdin/crowdin-api-client

PHP client library for Crowdin API v2

611.5M5](/packages/crowdin-crowdin-api-client)[smsapi.pl/php-client

SMSAPI API PHP Client

6581.4k1](/packages/smsapipl-php-client)[inspirum/balikobot

PHP library for Balikobot API

20379.7k4](/packages/inspirum-balikobot)[phplicengine/bitly

Bitly API v4

22277.3k](/packages/phplicengine-bitly)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)