v1 > Lookups > CsiDivisionsLookup
Lookup CSI divisions.
URL
/connect/v1/csidivisions
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' |
pageNumber |
number | Yes | The page number the search result will start from | Positive integer greater than 0 |
pageSize |
number | Yes | The maximum number of result by page | Integer between 1 and 100 |
code |
string | No | A unique csi division code | A string |
keyword |
string | No | Return csi divisions matching a keyword | A string |
Sample URL
/connect/v1/csidivisions?locale=en&pageNumber=1&pageSize=10&code=00 31 13.16
/connect/v1/csidivisions?locale=en&pageNumber=1&pageSize=10&keyword=table
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 | 'CSI' |
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 | The actual search result : a list of csi division | Array of csi division object |
result.data[].locale |
string | On success | An Origin supported locale | 'de', 'es_MX', 'en', 'fr' or 'zh_CN' |
result.data[].name |
string | On success | The name of this csi division | A string |
result.data[].code |
string | On success | The unique csi division code | A string |
Sample Response (Success):
HTTP Code : 200
{
"status":{
"state":"SUCCESS"
},
"result":{
"entityType":"CSI",
"searchInfo":{
"numberOfElements":"2",
"numberOfPages":"10"
},
"data":[
{
"locale":"en",
"name": "Unit Masonry",
"code": "04 20 00"
},
{
"locale":"en",
"name": "Brick Masonry",
"code": "04 21 13"
}
]
},
"connectRequest":{
"locale":"en",
"pageNumber":"1",
"pageSize":"2"
}
}
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 '0' for field pageNumber. Allowed value(s) : [positive integer not equal zero]",
"Request has invalid value 'es' for field locale. Allowed value(s) : [de, es_MX, en, fr, zh_CN]"
]
},
"connectRequest": {
"locale": "es",
"pageNumber": "0",
"pageSize": "100"
}
}