Adding/Removing Numbers

Adding Geographic Numbers By City to a Pool

To add numbers to your Number Pool that are local to a city/region, use the following end-point:

POST https://edgeapi.marchex.io/marketingedge/v5/api/numberpools/{number_pool_id}/numbers

{
    "quantity": 1,
    "top_up_with_tollfree": true,
    "phone_number_request": {
        "number_type": "international",
        "match_type": "geographic",
        "city": "London",
        "iso_country": "GB"
    }
}

Adding Geographic Numbers By Area/Dialing Code to a Pool

To add numbers to your Number Pool local to an area/dialling code, use the following end-point:

POST https:/edgeapi.marchex.io/marketingedge/v5/api/numberpools/{number_pool_id}/numbers

{
    "quantity": 1,
    "top_up_with_tollfree": true,
    "phone_number_request": {
        "number_type": "international",
        "match_type": "geographic",
        "area_code": "020",
        "iso_country": "GB"
    }
}

Adding Toll Free Numbers to a Pool

To add Toll Free numbers to your Number Pool, use the following end-point:

POST https://edgeapi.marchex.io/marketingedge/v5/api/numberpools/{number_pool_id}/numbers

{
    "quantity": 1,
    "phone_number_request": {
        "number_type": "international",
        "match_type": "tollfree",
        "iso_country": "GB"
    }
}

Adding National Numbers to a Pool

To add Toll Free numbers to your Number Pool, use the following end-point:

POST https://edgeapi.marchex.io/marketingedge/v5/api/numberpools/{number_pool_id}/numbers

{
    "quantity": 1,
    "phone_number_request": {
        "number_type": "international",
        "match_type": "national",
        "iso_country": "GB"
    }
}

Deleting Numbers from a Pool

To remove numbers from your Number Pool, use the following end-point:

DELETE https://edgeapi.marchex.io/marketingedge/v5/api/numberpools/{number_pool_id}/numbers/{number_id}