Rest a number
curl --request POST \
--url https://sandbox.voice.miraiminds.co/v2/phone-numbers/{phone_number_id}/rest \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"minutes": 60
}'import requests
url = "https://sandbox.voice.miraiminds.co/v2/phone-numbers/{phone_number_id}/rest"
payload = { "minutes": 60 }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const url = 'https://sandbox.voice.miraiminds.co/v2/phone-numbers/{phone_number_id}/rest';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({minutes: 60})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"id": "phn_01K9Q3A7C2E4G6J8M0P2R4T6V8",
"connection_id": "tcn_01K9Q2W5D8F3H6J9KMNPQRSTVW",
"provider": "plivo",
"ownership": "customer",
"number": "+918048123456",
"agent_id": "agt_01K2M4P7QRSTVWXYZ0A1B2C3",
"state": "ready",
"connection_state": "verified",
"version": 4,
"webhook_url": "",
"created_at": "2026-10-09T07:02:11.903215Z",
"health": {
"state": "resting",
"resting_until": "2026-10-15T11:30:00Z",
"cooling_until": null,
"retired_at": null,
"warming": null,
"attempts_this_hour": 12,
"attempts_today": 24,
"answers_today": 17,
"answer_rate_7d": 0.6955,
"series_7d": [
{
"day": "2026-10-09",
"attempts": 52,
"answers": 31
},
{
"day": "2026-10-10",
"attempts": 60,
"answers": 39
},
{
"day": "2026-10-11",
"attempts": 0,
"answers": 0
},
{
"day": "2026-10-12",
"attempts": 58,
"answers": 41
},
{
"day": "2026-10-13",
"attempts": 61,
"answers": 40
},
{
"day": "2026-10-14",
"attempts": 59,
"answers": 43
},
{
"day": "2026-10-15",
"attempts": 24,
"answers": 17
}
],
"rests_today": 0
},
"pools": [
{
"id": "ppl_01K9V2C4E6G8J0M2P4R6T8W0Y2",
"name": "Outreach"
}
]
}{
"error": {
"code": "number_retired",
"message": "This number is retired. Resume it before resting it."
}
}Phone numbers
Rest a number
Stops the number ringing out for minutes (1 to 1440). A campaign on it waits; a pool calls from its other numbers. People can still call it.
Numbers in a pool also rest on their own when their answers drop well below their pool-mates’. Resume brings one back early.
POST
/
v2
/
phone-numbers
/
{phone_number_id}
/
rest
Rest a number
curl --request POST \
--url https://sandbox.voice.miraiminds.co/v2/phone-numbers/{phone_number_id}/rest \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"minutes": 60
}'import requests
url = "https://sandbox.voice.miraiminds.co/v2/phone-numbers/{phone_number_id}/rest"
payload = { "minutes": 60 }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const url = 'https://sandbox.voice.miraiminds.co/v2/phone-numbers/{phone_number_id}/rest';
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({minutes: 60})
};
fetch(url, options)
.then(res => res.json())
.then(json => console.log(json))
.catch(err => console.error(err));{
"id": "phn_01K9Q3A7C2E4G6J8M0P2R4T6V8",
"connection_id": "tcn_01K9Q2W5D8F3H6J9KMNPQRSTVW",
"provider": "plivo",
"ownership": "customer",
"number": "+918048123456",
"agent_id": "agt_01K2M4P7QRSTVWXYZ0A1B2C3",
"state": "ready",
"connection_state": "verified",
"version": 4,
"webhook_url": "",
"created_at": "2026-10-09T07:02:11.903215Z",
"health": {
"state": "resting",
"resting_until": "2026-10-15T11:30:00Z",
"cooling_until": null,
"retired_at": null,
"warming": null,
"attempts_this_hour": 12,
"attempts_today": 24,
"answers_today": 17,
"answer_rate_7d": 0.6955,
"series_7d": [
{
"day": "2026-10-09",
"attempts": 52,
"answers": 31
},
{
"day": "2026-10-10",
"attempts": 60,
"answers": 39
},
{
"day": "2026-10-11",
"attempts": 0,
"answers": 0
},
{
"day": "2026-10-12",
"attempts": 58,
"answers": 41
},
{
"day": "2026-10-13",
"attempts": 61,
"answers": 40
},
{
"day": "2026-10-14",
"attempts": 59,
"answers": 43
},
{
"day": "2026-10-15",
"attempts": 24,
"answers": 17
}
],
"rests_today": 0
},
"pools": [
{
"id": "ppl_01K9V2C4E6G8J0M2P4R6T8W0Y2",
"name": "Outreach"
}
]
}{
"error": {
"code": "number_retired",
"message": "This number is retired. Resume it before resting it."
}
}⌘I