Get UN/LOCODE information.

GET /unlocodes/{code}

Sample request:

GET /unlocodes/UGMUK

Path parameters

  • code string Required

    UN/LOCODE code

Responses

  • 200 application/json

    Successful operation

    Hide response attributes Show response attributes object
    • code string | null

      UN/LOCODE have length of 5 - combination of Country code (length of 2) and Location code (length of 3)

      Minimum length is 0, maximum length is 5.

    • country string | null

      Two letters code of country

      Minimum length is 0, maximum length is 2.

    • name string | null

      Description about location

      Minimum length is 0, maximum length is 256.

    • subdivision string | null

      1-3 character alphabetic and/or numeric code for the administrative division of the country concerned(state, province, department, etc.)

      Minimum length is 0, maximum length is 3.

    • coordinates string | null

      Geographical coordinates (latitude/longitude)

      Format: ddmmN dddmmW, ddmmS dddmmE, etc.,

      Where the two last digits refer to minutes and the two or three first digits indicate the degrees.

      Minimum length is 0, maximum length is 12.

    • Additional properties are NOT allowed
  • 400 application/json

    Unexpected error

    Hide response attributes Show response attributes object
    • status string | null

      Error status

    • timestamp string(date-time)

      Error date

    • code string | null

      Error code
      - R101 : The container size type is unfound.
      - R102 : The country code is unfound.
      - R103 : The document type is unfound.
      - R104 : The location code is unfound.
      - R105 : The location type is unfound.
      - R106 : The packaging code is unfound.
      - R107 : The transport mode is unfound.
      - R108 : The transport mean type is unfound.
      - R109 : The event type is unfound.
      - R110 : The UN/LOCODE is unfound.
      - R111 : The actor is unfound.
      - R112 : The dangerous code is unfound.

    • message string | null

      Error message

    • Additional properties are NOT allowed
GET /unlocodes/{code}
curl \
 -X GET https://soget-api-integration.azure-api.net/api-referential-unitary/v1/unlocodes/{code} \
 -H "Authorization: Bearer $ACCESS_TOKEN" \
 -H "Ocp-Apim-Subscription-Key: $API_KEY"
Response examples (200)
{
  "code": "UGMUK",
  "country": "UG",
  "name": "Mukono",
  "subdivision": "108",
  "coordinates": "0021N 03245E"
}
Response examples (400)
{
  "status": "400",
  "timestamp": "2022-10-18T14:53:52.239Z",
  "code": "R001",
  "message": "Information not found."
}