# IPs The IP API endpoint allows you to access information regarding the IPs allocated to your Mailgun account that are used for outbound sending. ## Remove an IP from the domain pool, unlink a DIPP or remove the domain pool - [DELETE /v3/domains/{name}/ips/{ip}](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/ip-pools/delete-v3-domains--name--ips--ip-.md): The behavior of the endpoint depends on the value of the parameter. It can be one of the following: * a valid IP address: this IP address will be removed from the domain pool. * string : the entire domain pool will be removed. As far as the system is concerned, such domain will no longer exist. * string : the DIPP which is currently linked to the domain will be unlinked. ### Removing An IP Note that it's impossible to alter domain IPs if a DIPP is linked to the domain. If the account is not eligible for shared IPs, additional rules apply: * removing the last IP from the domain is not allowed; * if all of the remaining dedicated IPs are on warmup, an extra IP might be added to the domain pool. ### Unlinking The DIPP The account must have 'DIPPs' feature enabled. Either or query parameter must be specified, but not both. If the special value is used for the replacement IP, the account must be eligible for shared IPs. In this case the system will assign a shared IP as the replacement. ## Remove an IP from the domain pool, unlink a DIPP or remove the domain pool - [DELETE /v3/domains/{name}/pool/{ip}](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/ip-pools/delete-v3-domains--name--pool--ip-.md): The behavior of the endpoint depends on the value of the parameter. It can be one of the following: * a valid IP address: this IP address will be removed from the domain pool. * string : the entire domain pool will be removed. As far as the system is concerned, such domain will no longer exist. * string : the DIPP which is currently linked to the domain will be unlinked. ### Removing An IP Note that it's impossible to alter domain IPs if a DIPP is linked to the domain. If the account is not eligible for shared IPs, additional rules apply: * removing the last IP from the domain is not allowed; * if all of the remaining dedicated IPs are on warmup, an extra IP might be added to the domain pool. ### Unlinking The DIPP The account must have 'DIPPs' feature enabled. Either or query parameter must be specified, but not both. If the special value is used for the replacement IP, the account must be eligible for shared IPs. In this case the system will assign a shared IP as the replacement. ## Remove an IP from the domain pool, unlink a DIPP or remove the domain pool - [DELETE /v3/domains/{name}/ips/{ip}](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/ips/delete-v3-domains--name--ips--ip-.md): The behavior of the endpoint depends on the value of the parameter. It can be one of the following: * a valid IP address: this IP address will be removed from the domain pool. * string : the entire domain pool will be removed. As far as the system is concerned, such domain will no longer exist. * string : the DIPP which is currently linked to the domain will be unlinked. ### Removing An IP Note that it's impossible to alter domain IPs if a DIPP is linked to the domain. If the account is not eligible for shared IPs, additional rules apply: * removing the last IP from the domain is not allowed; * if all of the remaining dedicated IPs are on warmup, an extra IP might be added to the domain pool. ### Unlinking The DIPP The account must have 'DIPPs' feature enabled. Either or query parameter must be specified, but not both. If the special value is used for the replacement IP, the account must be eligible for shared IPs. In this case the system will assign a shared IP as the replacement. ## Remove an IP from the domain pool, unlink a DIPP or remove the domain pool - [DELETE /v3/domains/{name}/pool/{ip}](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/ips/delete-v3-domains--name--pool--ip-.md): The behavior of the endpoint depends on the value of the parameter. It can be one of the following: * a valid IP address: this IP address will be removed from the domain pool. * string : the entire domain pool will be removed. As far as the system is concerned, such domain will no longer exist. * string : the DIPP which is currently linked to the domain will be unlinked. ### Removing An IP Note that it's impossible to alter domain IPs if a DIPP is linked to the domain. If the account is not eligible for shared IPs, additional rules apply: * removing the last IP from the domain is not allowed; * if all of the remaining dedicated IPs are on warmup, an extra IP might be added to the domain pool. ### Unlinking The DIPP The account must have 'DIPPs' feature enabled. Either or query parameter must be specified, but not both. If the special value is used for the replacement IP, the account must be eligible for shared IPs. In this case the system will assign a shared IP as the replacement. ## List account IPs - [GET /v3/ips](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/ips/get-v3-ips.md): in response lists which IPs can be assigned to DIPPs; this field is present only if the account has 'DIPPs' feature enabled. contains the number of items returned in (this depends on the filters applied). ## Get details about account IP - [GET /v3/ips/{ip}](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/ips/get-v3-ips--ip-.md) ## Get all domains of an account where a specific IP is assigned - [GET /v3/ips/{ip}/domains](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/ips/get-v3-ips--ip--domains.md): The IP must belong to the account. Matching domains are ordered by increasing id, then the and parameters are applied. If the parameter is present, it is used to limit the results to domains whose names match the search query. The search query is split into words by whitespace and punctuation, then the logical OR is applied. ## Assign an IP to all account domains - [POST /v3/ips/{ip}/domains](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/ips/post-v3-ips--ip--domains.md): The IP must belong to the account. ## Remove an IP from all account domains - [DELETE /v3/ips/{ip}/domains](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/ips/delete-v3-ips--ip--domains.md): The IP must belong to the account. If the parameter is present, it is used to replace the removed ip on all domains. ## Place account IP into a dedicated IP band - [POST /v3/ips/{addr}/ip_band](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/ips/post-v3-ips--addr--ip-band.md): The feature must be enabled for the account. The IP must be a dedicated one belonging to the account. ## Return the number of IPs available to the account per its billing plan - [GET /v3/ips/request/new](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/ips/get-v3-ips-request-new.md): This endpoint remains active for backwards compatibility. Do not use it in new code. Field in the response is deprecated and should not be used. ## Add a new dedicated IP to the account - [POST /v3/ips/request/new](https://documentation.mailgun.com/docs/inboxready/api-reference/optimize/mailgun/ips/post-v3-ips-request-new.md): A new IP can be assigned only if billing limits allow that.