---
title: Application Mapping REST Interface
slug: ps/help/en_us/vwaf/ag/application-mapping-rest-interface
docTags: 
createdAt: 2026-08-02T10:05:41.696Z
---

## Data

Application mapping is a list of dictionary entries. Each entry specifies one particular mapping:

- application\_uuid
  The internal UUID of the mapped application.
- hosts
  A list of all hosts assigned in the particular mapping.
- prefixes
  A list of all prefixes assigned in the particular mapping.

:::hint{type="info"}
For more information regarding application mapping concepts, see [Application Mapping, Paths, Preconditions](docId\:GfHMSuU71Mo-mbj3skrNg).
:::

:::hint{type="info"}
For more information regarding editing application mapping using the user interface, see [Editing Application Mapping](docId\:rLuz-mFEsovgD1-d2n2bI).
:::

## Getting the configured customer keys

- Request

| Method    | GET                   |
| --------- | --------------------- |
| URL       | /application-mapping/ |
| Arguments | –                     |

- Response

| Reason code | Arguments                                | Meaning                                                                                                                      |
| ----------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| 200         | <br />`{ ..., "customer_keys": [ "" ] }` | dictionary containing all customer keys that are available<br />An underscore stands for the empty "\[Default Customer Key]" |
| 401         | –                                        | no login                                                                                                                     |
| 403         | –                                        | not enough rights                                                                                                            |
| 500         | –                                        | internal server error                                                                                                        |

## Getting the application mapping for a specific customer key

- Request

| Method    | GET                                                                                                                     |
| --------- | ----------------------------------------------------------------------------------------------------------------------- |
| URL       | /application-mapping/customer\_key<br />The empty “\[Default Customer Key]” needs to be addressed as “\_” (underscore). |
| Arguments | –                                                                                                                       |

- Response

| Reason code | Arguments                                            | Meaning                                                                                                                      |
| ----------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| 200         | <br />`{ ..., "customer_keys": [ "" ] }`<br /><br /> | dictionary containing all customer keys that are available<br />An underscore stands for the empty "\[Default Customer Key]" |
| 401         | –                                                    | no login                                                                                                                     |
| 403         | –                                                    | not enough rights                                                                                                            |
| 404         | –                                                    | no application mapping exists for the given customer key                                                                     |
| 500         | –                                                    | internal server error                                                                                                        |

- Example

The following request retrieves the application mapping for the empty \[Default Customer Key].

```bash
$ curl -n https://something.com:8087/api/af/latest/application-mapping/_ {    "__name": "_",    "__path": "/api/af/latest/application-mapping/_/",    "__subnodes": [],    "customer_key": "",    "mapping": [      {        "application_uuid": "6b35f8fb2d65288d-5dbded6e7c4389a81c1b28d43eea8628",        "hosts": [          "api.something.de"        ],        "prefixes": [          ""        ]      },      {      ...
```