v2 > Lookups > ProjectPhasesLookup

Get available project's phases.

  • URL

    /connect/v2/project-phases

  • Method:

    GET

  • URL Params

Param Type Required Description Domain of value
locale string Yes An Origin supported locale 'de', 'es_MX', 'en', 'fr' or 'zh_CN'

  • Sample URL

    /connect/v2/project-phases?locale=en

  • Request :

    The request has no body.

  • Response :

Field Type Presence Description Domain of value
status object Always The execution status A status object
status.state string Always The state of execution 'SUCCESS' or 'ERROR'
status.code string On error The general error code and message See Errors reference
status.messages[] array of string On error List of errors causes A validation message or other causes
result object On success The execution result A result object
result.entityType string On success The type of entity this result is about 'PROJECT_PHASE'
result.searchInfo object On success Informations about the search result pages A searchInfo object
result.searchInfo.numberOfElements object On success The total number of elements found A positive integer
result.searchInfo.numberOfPages object On success The total number of pages NumberOfElements / pageSize
result.data[] array of object On success A list of phase values Array of value object
result.data[].name string On success The name of the phase A string
result.data[].code string On success The unique code of the phase A string
connectRequest object Always The exact request sent that produced this response A ProjectPhasesLookup request

Sample Response (Success)

  • HTTP Code : 200
{
  "connectRequest": {
    "locale": "en"
  },
  "result": {
    "data": [
      {
        "code": "PRJ_PHASE_PROGRAMMING_AND_FEASIBILITY",
        "name": "Programming and Feasibility"
      },
      {
        "code": "PRJ_PHASE_CONCEPTUAL_DESIGN",
        "name": "Conceptual Design"
      },
      {
        "code": "PRJ_PHASE_SCHEMATIC_DESIGN",
        "name": "Schematic Design"
      },
      {
        "code": "PRJ_PHASE_DESIGN_DEVELOPMENT",
        "name": "Design Development"
      },
      {
        "code": "PRJ_PHASE_CONSTRUCTION_DOCUMENTATION",
        "name": "Construction Documentation"
      },
      {
        "code": "PRJ_PHASE_CONSTRUCTION_BIDDING",
        "name": "Construction Bidding"
      },
      {
        "code": "PRJ_PHASE_CONSTRUCTION_ADMINISTRATION",
        "name": "Construction Administration"
      },
      {
        "code": "PRJ_PHASE_OPERATIONS_AND_MAINTENANCE",
        "name": "Operations and Maintenance"
      }
    ],
    "entityType": "PROJECT_PHASE",
    "searchInfo": {
      "numberOfElements": "8",
      "numberOfPages": "1"
    }
  },
  "status": {
    "state": "SUCCESS"
  }
}

Sample Response (Error)

  • HTTP Code : 400, 500
{
  "status": {
    "state": "ERROR",
    "code": "CE00001 - Connect request failed validation. Refer to provided messages for details.",
    "messages": [
      "Request has invalid value 'es' for field locale. Allowed value(s) : [de, es_MX, en, fr, zh_CN]"
    ]
  },
  "connectRequest": {
    "locale": "es"
  }
}

results matching ""

    No results matching ""