Get sources

get/v1/environments/{environmentId}/sources
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 sources

Retrieve a list of configured sources in the specified environment.

Request parameters

cURL request example

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

Path Parameters

  • environmentId
    required, string

    Identifies the specific environment that you're operating in or on behalf of.

Response fields and example

Example payload generated from schema
1
{
2
"meta": {
3
"version": "1.0.0"
4
},
5
"payload": {
6
"sources": [
7
{
8
"name": "string",
9
"id": "string",
10
"environment": {
11
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
12
"environmentFlag": "Staging"
13
},
14
"sftpUsername": "string",
15
"hasSFTPPassword": true,
16
"serviceRegion": "AWS_USA_EAST_1",
17
"dataFormat": "HL7V2",
18
"ehr": "string",
19
"apiKey": "string",
20
"hasSecret": true,
21
"setupState": {
22
"step": "string",
23
"name": "string",
24
"dataFormat": "HL7V2",
25
"ehr": "string",
26
"serviceRegion": "AWS_USA_EAST_1"
27
},
28
"timeZone": "string"
29
}
30
]
31
}
32
}
  • 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 source(s).

    • sources
      Array of object

      Contains an array of sources.

      • name
        string

        Displays the human-readable name of the source.

      • id
        string

        Displays the unique identifier (i.e., client ID) of the source.

      • environment
        object

        Contains metadata about the environment within the associated Redox organization.

        • id
          string

          Contains the unique identifier of the Redox environment.

          Format: uuid
        • environmentFlag
          string

          Indicates whether the environment is used for development, staging, or production.

          Possible Values: Production, Staging, Development
      • sftpUsername
        string

        Contains a UUID that represents the username for this source's SFTP access. In order to view, this field must be enabled for your organization. Talk to your Technical Account Manager if your organization needs this field.

      • hasSFTPPassword
        boolean

        Indicates whether an SFTP password exists for this source. In order to view, this field must be enabled for your organization. Talk to your Technical Account Manager if your organization needs this field.

      • serviceRegion
        string

        Specifies the Redox service region where the source resides. You can't change this after creation.

        Possible Values: AWS_USA_EAST_1, AWS_CAN_CENTRAL, GCP_USA_CENTRAL_1
      • dataFormat
        string

        Displays the data format of the source.

        Possible Values: HL7V2, JSON, Custom, X12, X12v2, XML (to JSON)
      • ehr
        string

        Displays the EHR or sending system type of the source.

      • apiKey
        string

        Displays the API key of the source. This is server-generated when the source is created and can't be changed.

      • hasSecret
        boolean

        Displays whether the source has a secret.

      • setupState
        nullable, object

        Describes the current state of configuration for a source in your Redox organization.

        • step
          required, string

          Indicates which step the user is on in the configuration process.

        • name
          string

          Displays the human-readable name of the source, as configured during setup.

        • dataFormat
          string

          Displays the data format of the source.

          Possible Values: HL7V2, JSON, Custom, X12, X12v2, XML (to JSON)
        • ehr
          string

          Displays the EHR or sending system type of the source.

        • serviceRegion
          string

          Specifies the Redox service region where the source resides. You can't change this after creation.

          Possible Values: AWS_USA_EAST_1, AWS_CAN_CENTRAL, GCP_USA_CENTRAL_1
      • timeZone
        string

        Specifies the time zone that should be used when parsing dates/times from the sending system.