Company

SupportAPIDashboard

Legal

Terms of usePrivacy policy

© 2026 VerifySMS. All rights reserved.

    verifysms
    Guides
    • Getting Started
    API Endpoints
    • Get services
    • Get balance
    • Rent a number
    • Get code
    • Cancel a number
    Reference
    • Service Codes

    Getting Started

    To get started with the API, you need to create an account and obtain an API key. You can do this by signing up for an account.

    Once you have an account, you can get your API key in the profile section. This key will be used to authenticate your requests to the API.



    GET

    /api/services


    Get services

    This will return a list of services that are available for the user to rent.

    Required attributes

    None

    Possible errors

    None

    curl https://verifysms.io/api/services

    Response (200)

    {
      "zf": {
        "name": "Coinbase",
        "cost": 1,
        "in_stock": true
      },
      "ty": {
        "name": "DoorDash",
        "cost": 0.5,
        "in_stock": true
      }
    }


    GET

    /api/balance


    Get balance

    This endpoint will retrieve the current balance (in USD) of the user.

    Required attributes

    None

    Possible errors

    401

    Invalid API key

    curl https://verifysms.io/api/balance \
    	-H "API-KEY: {api_key}"

    Response (200)

    120.87


    POST

    /api/rent


    Rent a number

    This endpioint will rent a phone number and subtract your balance into your locked balance.

    Required attributes

    codestring

    Service code. For example 'bq' for Signal verification.

    carriersstring[] (optional)

    Optional carriers array to select from. Possible values: 'verizon', 'att', 'tmobile'. If none are provided, a random carrier will be selected.

    Possible errors

    400

    Invalid request body (missing code, invalid carriers, invalid days/auto_renew, or invalid carrier).

    401

    Invalid API key

    402

    Insufficient balance

    404

    Service not found

    409

    No numbers available right now.

    curl https://verifysms.io/api/rent \
    	-X POST \
    	-H "API-KEY: {api_key}" \
    	-H "Content-Type: application/json" \
    	-d '{"code":"bq"}'

    Response (200)

    {
      "number": "4345122324",
      "cost": 0.1,
      "code": "bq",
      "service": "Signal",
      "transaction_id": "b3f0cdaa-d50f-409d-b032-08bb61671379"
    }


    GET

    /api/code


    Get code

    This endpoint will retrieve the code that was received from the rented number. If you want to receive the code via webhook, please add your webhook URL to your profile settings.

    Required attributes

    transaction_iduuid

    ID of the transaction to cancel. This ID is returned when you rent a number.

    Possible errors

    400

    Transaction ID is missing; Transaction cancelled

    401

    Invalid API key

    404

    Transaction not found

    409

    Code not received yet

    curl https://verifysms.io/api/code?transaction_id=b3f0cdaa-d50f-409d-b032-08bb61671379 \
    	-H "API-KEY: {api_key}"

    Response (200)

    422316


    POST

    /api/cancel


    Cancel a number

    This endpioint will cancel your phone rental and return the locked balance to your balance.

    Required attributes

    transaction_iduuid

    ID of the transaction to cancel. This ID is returned when you rent a number.

    Possible errors

    400

    Transaction ID is missing; Can't cancel a transaction that received a code; Transaction already cancelled

    401

    Invalid API key

    404

    Transaction not found

    curl https://verifysms.io/api/cancel \
    	-X POST \
    	-H "API-KEY: {api_key}" \
    	-H "Content-Type: application/json" \
    	-d '{"transaction_id":"b3f0cdaa-d50f-409d-b032-08bb61671379"}'

    Response (200)

    None

    Service Codes

    Below is a table of all available service codes and their descriptions:

    CodeDescription
    gyVKontakte
    dfGoogle / Gmail / Youtube
    jnBadoo
    jxTikTok
    khMicrosoft / Outlook / Hotmail
    fwlCurrently.com
    hksService not listed
    hqjPixels.xyz
    kjWeChat
    jnkResy.com
    klAmazon / AWS
    klxGoogle Messenger
    lhYahoo
    rdtBlastbucks
    lrcTruth Social
    lsSnapchat
    thTrapCall
    mqTemu
    npLyft
    wcCash App
    nxeBay
    nxdChevron / TexaCo
    ylmCollege Pulse
    ypdNoonlight
    yxtPVC
    pzDiscord
    qrEneba
    zxcLAA
    gnHinge
    hsAOL
    vtCraigslist
    hxnCredit Karma
    wlLinkedIn
    zfCoinbase
    ctnFetLife
    xgpUber
    xhViber
    xmMercari
    gbcCurrent.com
    plvChase
    jfLINE messenger
    rwzNeocrypto
    ngWhatsApp
    fyApple
    vjNike
    xzHily
    khbLeague of Legends
    kvTwitter
    kvjSwagbucks / InboxDollars / MyPoints / ySense / Noones / Adgate Survey
    kwjCoca-Cola
    wfPayPal
    lmvRing4
    nvlKudos
    pmyGaintplay
    pwxSideline / Index by Pinger
    qcSteam
    rqGoogle Voice
    sbLinode
    tmGrindr
    bxOpenAI / ChatGPT
    sfZillow
    zkqVenmo
    steSeated
    bqSignal
    bwFiverr
    djCrowdTap
    dmPoshmark
    gkOkCupid
    tgTelegram
    zabcGoogle Chat
    zjadRove Miles
    zmmaCiti Bank
    eiBumble
    bhrClaude AI
    yfzTinder
    zlwTextFree
    fwkIbotta
    hynTextr
    mgBlizzard / Battle.net
    zrPlenty of Fish
    rnTimewall
    wtntWhatnot
    yqJD.com
    zqxpAARP Rewards
    fbbFacebook
    tyDoorDash
    zhmEtsy
    ctpsCapital One Shopping
    wdkTicketmaster
    fcWalmart
    rpInstagram
    hjbGopuff
    aamdAshley Madison