This request will mark a number or the series it belongs to as pre-reserved.
This is used by resellers to reserve numbers for a potential customer. A pre-reservation will last for 14 days before it is terminated and the numbers are available to everyone again.
This request can also release a pre-reserved number if it should not be reserved anymore.
| URL | https://api.telecomx.dk/number/NUMBER_ID/preReserve | |
|---|---|---|
| Method | GET | |
| Access level | RESELLER, RESELLER_ADMIN or ADMIN. Only admins may release another reseller's reservation, or pre-reserve locked/closed numbers. |
|
| Param | NUMBER_ID | The number (E.164 format) to pre-reserve |
| Query | release | [optional] True if the number(s) should not be reserved anymore. Defaults to false. |
GET https://api.telecomx.dk/number/+4570305050/preReserve GET https://api.telecomx.dk/number/+4570305050/preReserve?release=true
| Json object | ||
|---|---|---|
| success | Boolean | True on success |
{ "success": true }
| Error code | Message | Description |
|---|---|---|
| 422 | id | Number is invalid (not E.164 format) |
| 409 | id | Number(s) are not available for pre reservation |
| 409 | id | Number(s) are not available for pre reservation release |
| 403 | access_denied | Insufficient access level |
| 404 | not_found | Number not found |
| 500 | internal_error | <Unspecified> |