REST API for Clinical One Platform

Get region by country or state Id

get

/ec-site-svc/rest/v2/studies/{studyId}/{mode}/regions/filter/countries/{countryId}

Retrieves a region by country or state ID. Rights required: RegionGet. Returns region to which the country and states(if passed) is associated. Null is returned if country is not associated with any region. Region does not include associated countries list.

Request

Path Parameters

countryId(required): string

Country Id for the associated region.
mode(required): string

Mode of the study. Accepts active, test, or training.
studyId(required): string(uuid)

The ID of the study.

Query Parameters

stateId: string

State ID.

There's no request body for this operation.

Response

Supported Media Types

application/json

200 Response

Successful operation

Root Schema : schema

Type: object

Show Source

comment: string

Minimum Length: 0

Maximum Length: 2048
id: string (uuid)
name(required): string

Minimum Length: 1

Maximum Length: 100
reason: string

Minimum Length: 0

Maximum Length: 255
regionCountries(required): array regionCountries

Minimum Number of Items: 1

Maximum Number of Items: 2147483647
versionStart: string (date-time)

{
    "required":[
        "name",
        "regionCountries"
    ],
    "type":"object",
    "properties":{
        "reason":{
            "maxLength":"255",
            "minLength":"0",
            "type":"string"
        },
        "comment":{
            "maxLength":"2048",
            "minLength":"0",
            "type":"string"
        },
        "id":{
            "type":"string",
            "format":"uuid"
        },
        "versionStart":{
            "type":"string",
            "format":"date-time"
        },
        "name":{
            "maxLength":"100",
            "minLength":"1",
            "type":"string"
        },
        "regionCountries":{
            "maxItems":"2147483647",
            "minItems":"1",
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/RegionCountryDto"
            }
        }
    }
}

Nested Schema : regionCountries

Type: array

Minimum Number of Items: 1

Maximum Number of Items: 2147483647

Show Source

Array of: object RegionCountryDto

{
    "maxItems":"2147483647",
    "minItems":"1",
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/RegionCountryDto"
    }
}

Nested Schema : RegionCountryDto

Type: object

Show Source

comment: string

Minimum Length: 0

Maximum Length: 2048
countryId(required): string (uuid)
countryName: string
id: string (uuid)
reason: string

Minimum Length: 0

Maximum Length: 255
versionStart: string (date-time)

{
    "required":[
        "countryId"
    ],
    "type":"object",
    "properties":{
        "reason":{
            "maxLength":"255",
            "minLength":"0",
            "type":"string"
        },
        "comment":{
            "maxLength":"2048",
            "minLength":"0",
            "type":"string"
        },
        "id":{
            "type":"string",
            "format":"uuid"
        },
        "versionStart":{
            "type":"string",
            "format":"date-time"
        },
        "countryId":{
            "type":"string",
            "format":"uuid"
        },
        "countryName":{
            "type":"string"
        }
    }
}