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

    servicestring

    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 \
    	-H "API-KEY: {api_key}" \
    	-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 \
    	-H "API-KEY: {api_key}" \
    	-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
    lsSnapchat
    dfGoogle / Gmail / Youtube
    ngWhatsApp
    fwlCurrently.com
    fyApple
    gnHinge
    hksService not listed
    hqjPixels.xyz
    hsAOL
    hxnCredit Karma
    nxeBay
    jnkResy.com
    klAmazon / AWS
    klxGoogle Messenger
    plvChase
    rdtBlastbucks
    kjWeChat
    rwzNeocrypto
    thTrapCall
    tmGrindr
    wcCash App
    ylmCollege Pulse
    ypdNoonlight
    yxtPVC
    zfCoinbase
    zhmEtsy
    zxcLAA
    jxTikTok
    kvTwitter
    kvjSwagbucks / InboxDollars / MyPoints / ySense / Noones / Adgate Survey
    lhYahoo
    zkqVenmo
    lmvRing4
    bqSignal
    xhViber
    lrcTruth Social
    khMicrosoft / Outlook / Hotmail
    rpInstagram
    bwFiverr
    djCrowdTap
    gbcCurrent.com
    wfPayPal
    jfLINE messenger
    khbLeague of Legends
    kwjCoca-Cola
    mqTemu
    npLyft
    nxdChevron / TexaCo
    nvlKudos
    pzDiscord
    qrEneba
    rqGoogle Voice
    sbLinode
    vtCraigslist
    wlLinkedIn
    pmyGaintplay
    xgpUber
    bxOpenAI / ChatGPT
    ctnFetLife
    dmPoshmark
    xmMercari
    fcWalmart
    gkOkCupid
    gyVKontakte
    hjbGopuff
    jnBadoo
    pwxSideline / Index by Pinger
    qcSteam
    zabcGoogle Chat
    zjadRove Miles
    zmmaCiti Bank
    zqxpAARP Rewards
    zrPlenty of Fish
    fbbFacebook
    wdkTicketmaster
    tyDoorDash
    aamdAshley Madison
    wtntWhatnot
    ctpsCapital One Shopping
    bhrClaude AI
    eiBumble
    fwkIbotta
    hynTextr
    mgBlizzard / Battle.net
    rnTimewall
    vjNike
    xzHily
    yfzTinder
    yqJD.com
    zlwTextFree
    Updated API Error codes•Starting from Saturday, March 14 2026, we will be returning 4xx error codes instead of 5xx error codes in our API. Learn more at: https://verifysms.io/docs