Home
API reference
Platform API
Platform API
Sources
Get portmaps

Get portmaps

get/v1/sources/{sourceId}/portmaps
Page View

Source endpoints allow you to manage sources and their related portmaps in a specified environment. Portmaps include a port, virtual host (vhost), source, and list of host IPs.

You must be a member of the environment and be assigned to an engineer role to manage sources. Learn about roles.

Get portmaps

Retrieve any available portmaps for the specified source.

This is helpful for programmatically managing MLLP sources or reviewing which host IPs are directed to which sources.

Request parameters

cURL request example

bash
1
curl 'https://api.redoxengine.com/platform/v1/sources/{sourceId}/portmaps' \
2
--request GET \
3
--header 'Authorization: Bearer $API_TOKEN' \
4
--header 'accept: application/json'

Path Parameters

  • sourceId
    required, string

    Displays the unique identifier of a source within a given environment.

Response fields and example

Example payload generated from schema
1
{
2
  "meta": {
3
    "version": "1.0.0"
4
  },
5
  "payload": {
6
    "portmaps": [
7
      {
8
        "id": 0,
9
        "vhost": 0,
10
        "port": 0,
11
        "hostips": [
12
          "string"
13
        ]
14
      }
15
    ]
16
  }
17
}
  • meta
    object
    • version
      string

      Lists the major and minor version number for the format of the returned payload. The payload format or shape may change between minor versions, like including additional or extended fields in later versions. We include the version data in each response so that you have the option to handle the signaled differences.

  • payload
    object

    Contains the payload with details about the requested portmap(s).

    • portmaps
      Array of object

      Contains an array of portmaps.

      • id
        number

        Displays the unique identifier of the portmap.

      • vhost
        number

        Displays the ID of the Redox vhost that the port is mapped for.

      • port
        number

        Displays the port number that is being mapped. Must be between 9960 and 9999 (inclusive).

      • hostips
        Array of string

        Displays the list of host IPs for the portmap.

        Format: cidr