v2 > Lookups > ProjectTypesLookup
Get available project's types.
URL
/connect/v2/project-types
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-types?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_TYPE' |
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 type values | Array of value object |
result.data[].name |
string | On success | The name of the type | A string |
result.data[].code |
string | On success | The unique code of the type | A string |
connectRequest |
object | Always | The exact request sent that produced this response | A ProjectTypesLookup request |
Sample Response (Success):
HTTP Code : 200
{
"connectRequest": {
"locale": "en"
},
"result": {
"data": [
{
"code": "COMMERCIAL",
"name": "Commercial"
},
{
"code": "EDUCATIONAL",
"name": "Educational"
},
{
"code": "HEALTHCARE",
"name": "Healthcare"
},
{
"code": "HOSPITALITY",
"name": "Hospitality"
},
{
"code": "INSTITUTIONAL",
"name": "Institutional"
},
{
"code": "RESIDENTIAL",
"name": "Residential"
},
{
"code": "MULTI-RES",
"name": "Multi-Residential"
},
{
"code": "RETAIL",
"name": "Retail"
},
{
"code": "OTHER",
"name": "Other"
}
],
"entityType": "PROJECT_TYPE",
"searchInfo": {
"numberOfElements": "9",
"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"
}
}