TempNum Bot API Documentation

GET /numbers

Retrieve lists of assigned numbers grouped by country and service configurations.

Parameter	Required	Type	Description
`service`	Optional	String	Filters results by service name (e.g. `whatsapp`).
`country_id`	Optional	String	Filters results by country ID (e.g. `237_whatsapp`).

Example Request

/numbers?service=whatsapp

Response Schema (JSON)

{
    "status": "success",
    "data": [
        {
            "country_id": "237_whatsapp",
            "code": "237",
            "name": "Cameroon",
            "service": "Whatsapp",
            "stock": 150,
            "per_otp_earn": 0.005,
            "numbers": [
                "+237612345678",
                "+237698765432"
            ]
        }
    ]
}

GET /otps

Retrieve real-time received OTP codes filtered by number.

Parameter	Required	Type	Description
`number`	Optional	String	Filters results to a specific phone number (e.g. `237612345678`).

Example Request

/otps?number=237612345678

Response Schema (JSON)

{
    "status": "success",
    "data": [
        {
            "time": "2026-05-24T12:00:00",
            "service": "Whatsapp",
            "number": "+237612345678",
            "otp": "123456",
            "country": "Cameroon",
            "full_message": "Use verification code 123456 for WhatsApp registration"
        }
    ]
}

GET /getfile

Download the raw newline-separated file containing active phone numbers for a specific country.

Parameter	Required	Type	Description
`country_id`	Required	String	Identifier of the country/service (e.g. `237_whatsapp`).

Example Request

/getfile?country_id=237_whatsapp

Response Format (Plain Text)

+237612345678
+237698765432

ERR Error Responses

Standard structure for errors (e.g., resource not found, rate limits, invalid params).

{
    "status": "error",
    "message": "Too Many Requests. Rate limit exceeded."
}