Mobilerun Tools/Number API
The Tools/Number API from Mobilerun — 3 operation(s) for tools/number.
The Tools/Number API from Mobilerun — 3 operation(s) for tools/number.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/mobilerun-ai:mobilerun-ai-tools-number-api"
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.
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: 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)