Retrieving Hostnames & IPs

To make it a little easier to stay up to date with our hostnames and related IP addresses, we added an API endpoint you can call to retrieve the current list. We provide both our base hostnames and our edge hostnames. The base hostnames include information like our API endpoint, our web console, our developer console and similar. The edge hostnames cover everything our gateways need in order to communicate with our cloud and management services. These are particularly valuable for security teams, as these often need to be whitelisted due to firewall and security rules.

Put this URL in the address field for any browser, or run a GET request using an app or REST client (no token needed):

https://api.mapped.com/env

You'll receive a JSON formatted list like this as a response:

Copy
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
{
  "result": {
    "base": {
      "hostnames": [
        "account.mapped.com",
        "api.mapped.com",
        "app.mapped.com",
        "connectors.mapped.com",
        "developer.mapped.com",
        "push.mapped.com",
        "webhooks.mapped.com"
      ],
      "ipv4_cidrs": [
        "104.17.207.164/32",
        "104.17.32.228/32"
      ],
      "ipv6_cidrs": [
        "2606:4700::6811:20e4/128",
        "2606:4700::6811:cfa4/128"
      ]
    },
    "edge": {
      "hostnames": [
        "api.mapped.com",
        "api.mgmt.edge.mapped.com",
        "api.telemetry.edge.mapped.com",
        "c2d.edge.mapped.com",
        "cloudlink.mgmt.edge.mapped.com",
        "d2c.edge.mapped.com",
        "delta.mgmt.edge.mapped.com",
        "logs.mgmt.edge.mapped.com",
        "logs.telemetry.edge.mapped.com",
        "process.telemetry.edge.mapped.com",
        "registry.mgmt.edge.mapped.com",
        "s3.mgmt.edge.mapped.com"
      ],
      "ipv4_cidrs": [
        "104.17.207.164/32",
        "104.17.32.228/32",
        "172.65.168.191/32"
      ],
      "ipv6_cidrs": [
        "2606:4700:90:0:4616:f0ee:e66:bd6d/128",
        "2606:4700::6811:20e4/128",
        "2606:4700::6811:cfa4/128"
      ]
    },
    "etag": "e9c9431cd3b0f9507f679ae518e0bf1fbdde8cfc406c9dbc9aabdf0dbaf4bc64"
  },
  "success": true,
  "errors": [],
  "messages": []
}

While we won't change these hostnames and IPs on a frequent basis, old services may be deprecated or updated, new services may be added, environments may change, all of which can result in a new list.