Mobilerun Tools/Number API

The Tools/Number API from Mobilerun — 3 operation(s) for tools/number.

GitHub OpenAPI

Operations 5

GET /devices/number-bindings List number bindings #
GET /devices/number-bindings/candidates List number binding candidates #
DELETE /devices/{deviceId}/number Unbind the device's phone number #
GET /devices/{deviceId}/number Get the device's bound phone number #
POST /devices/{deviceId}/number Bind a phone number to the device #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/mobilerun-ai:mobilerun-ai-tools-number-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

mobilerun-ai-tools-number-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Mobilerun Ai Tools/Number API
  version: v1
  contact:
    name: Droidrun
    email: support@droidrun.ai
  description: 'Operations tagged Tools/Number across 2 of this provider''s published API definitions: openapi.json, mobilerun-ai-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.mobilerun.ai
  description: Droidrun Cloud API
security:
- bearerAuth: []
tags:
- name: Tools/Number
paths:
  /devices/number-bindings:
    get:
      operationId: list-number-bindings
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NumberItemsOutputListItemBody'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      tags:
      - Tools/Number
      summary: List number bindings
      x-summary-source: derived
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
  /devices/number-bindings/candidates:
    get:
      operationId: list-number-binding-candidates
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NumberItemsOutputCandidateBody'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      tags:
      - Tools/Number
      summary: List number binding candidates
      x-summary-source: derived
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
  /devices/{deviceId}/number:
    delete:
      description: Releases the number bound to the device. The device returns to its own default line; SMS to the number stop reaching the device.
      operationId: unbind-device-number
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NumberState'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Unbind the device's phone number
      tags:
      - Tools/Number
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
      - in: header
        name: X-Device-Display-ID
        schema:
          default: 0
          format: int64
          minimum: 0
          type: integer
    get:
      description: Returns the cloud number bound to the device and the SIM line the device presents (carrier, number).
      operationId: get-device-number
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NumberState'
          description: OK
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Error
      summary: Get the device's bound phone number
      tags:
      - Tools/Number
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
      - in: header
        name: X-Device-Display-ID
        schema:
          default: 0
          format: int64
          minimum: 0
          type: integer
    post:
      description: Binds one of your cloud numbers to the device. The device's SIM shows the number and every SMS it receives is delivered into the device's messages app. Available on devices whose capabilities report telephony. A number can be bound to one device, and a device holds one number; unbind first to move it.
      operationId: bind-device-number
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BindNumberInputBody'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NumberState'
          description: OK
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Bad Request
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Not Found
        '409':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Conflict
        '422':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Unprocessable Entity
        '500':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Internal Server Error
        '502':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Bad Gateway
        '503':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ErrorModel'
          description: Service Unavailable
      summary: Bind a phone number to the device
      tags:
      - Tools/Number
      parameters:
      - in: path
        name: deviceId
        required: true
        schema:
          type: string
      - in: header
        name: X-Device-Display-ID
        schema:
          default: 0
          format: int64
          minimum: 0
          type: integer
    servers:
    - url: https://api.mobilerun.ai
      description: Droidrun Cloud API
components:
  schemas:
    SIMCarrier:
      additionalProperties: false
      properties:
        countryIso:
          type: string
        mcc:
          type: string
        mnc:
          type: string
        name:
          type: string
      required:
      - name
      - mcc
      - mnc
      - countryIso
      type: object
    Candidate:
      additionalProperties: false
      properties:
        id:
          type: string
        name:
          type: string
        state:
          enum:
          - ready
          type: string
      required:
      - id
      - name
      - state
      type: object
    NumberItemsOutputListItemBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/schemas/NumberItemsOutputListItemBody.json
          format: uri
          readOnly: true
          type: string
        items:
          items:
            $ref: '#/components/schemas/ListItem'
          type:
          - array
          - 'null'
      required:
      - items
      type: object
    NumberItemsOutputCandidateBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/schemas/NumberItemsOutputCandidateBody.json
          format: uri
          readOnly: true
          type: string
        items:
          items:
            $ref: '#/components/schemas/Candidate'
          type:
          - array
          - 'null'
      required:
      - items
      type: object
    NumberState:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/schemas/NumberState.json
          format: uri
          readOnly: true
          type: string
        binding:
          $ref: '#/components/schemas/Binding'
        line:
          $ref: '#/components/schemas/SIMLine'
      required:
      - binding
      - line
      type: object
    SIMLine:
      additionalProperties: false
      properties:
        carrier:
          $ref: '#/components/schemas/SIMCarrier'
        defaultNumber:
          type: boolean
        iccid:
          type: string
        kind:
          enum:
          - simulated
          - uicc
          - esim
          - unknown
          type: string
        lineId:
          type: string
        numberSource:
          enum:
          - backend_default
          - caller
          - unknown
          type: string
        phoneNumber:
          type: string
        state:
          enum:
          - pending
          - active
          - inactive
          - failed
          - unknown
          type: string
      required:
      - lineId
      - kind
      - state
      - carrier
      - numberSource
      - defaultNumber
      type: object
    BindNumberInputBody:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/schemas/BindNumberInputBody.json
          format: uri
          readOnly: true
          type: string
        numberId:
          description: The cloud number's id.
          format: uuid
          type: string
      required:
      - numberId
      type: object
    ErrorModel:
      additionalProperties: false
      properties:
        $schema:
          description: A URL to the JSON Schema for this object.
          examples:
          - https://example.com/schemas/ErrorModel.json
          format: uri
          readOnly: true
          type: string
        detail:
          description: A human-readable explanation specific to this occurrence of the problem.
          examples:
          - Property foo is required but is missing.
          type: string
        errors:
          description: Optional list of individual error details
          items:
            $ref: '#/components/schemas/ErrorDetail'
          type:
          - array
          - 'null'
        instance:
          description: A URI reference that identifies the specific occurrence of the problem.
          examples:
          - https://example.com/error-log/abc123
          format: uri
          type: string
        status:
          description: HTTP status code
          examples:
          - 400
          format: int64
          type: integer
        title:
          description: A short, human-readable summary of the problem type. This value should not change between occurrences of the error.
          examples:
          - Bad Request
          type: string
        type:
          default: about:blank
          description: A URI reference to human-readable documentation for the error.
          examples:
          - https://example.com/errors/example
          format: uri
          type: string
      type: object
    ErrorDetail:
      additionalProperties: false
      properties:
        location:
          description: Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'
          type: string
        message:
          description: Error message text
          type: string
        value:
          description: The value at the given location
      type: object
    ListItem:
      additionalProperties: false
      properties:
        boundAt:
          format: date-time
          type: string
        deviceId:
          type: string
        deviceName:
          type: string
        numberId:
          type: string
      required:
      - numberId
      - deviceId
      - deviceName
      - boundAt
      type: object
    Binding:
      additionalProperties: false
      properties:
        boundAt:
          format: date-time
          type: string
        numberId:
          type: string
        phoneNumber:
          type: string
      required:
      - numberId
      - phoneNumber
      - boundAt
      type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: Opaque
      description: Bearer token via Authorization header
x-refined-from:
- openapi.json
- mobilerun-ai-openapi.json
x-provenance:
  method: harvested
  publisher: Mobilerun
  source: https://api.mobilerun.ai/v1/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)