v2 > Lookups > StandardsLookup
Lookup Origin supported standards, labels and test reports list. Custom standards, labels and test reports are not returned by the service
URL
/connect/v2/standards
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 |
standardType |
string | Yes | The type to get standards, labels or test reports | 'STANDARD', 'LABEL' or 'TESTREPORT' |
keyword |
string | No | Return standards, labels or test reports matching a keyword | Any String (default value '*') |
Sample URL
/connect/v2/standards?locale=en&pageNumber=1&pageSize=10&standardType=STANDARD&keyword=green
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 | 'STANDARD' |
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 standards | Array of standard 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 standard | A string |
result.data[].code |
string | On success | The unique standard code | A string |
result.data[].standardProperties[] |
array of object | On success | A list of standard properties used in certification or declaration featuresProperties | Array of property object |
result.data[].standardProperties[].name |
string | On success | The name of this standard property | A string |
result.data[].standardProperties[].code |
string | On success | The unique standard code property | A string |
connectRequest |
object | Always | The exact request sent that produced this response | A StandardsLookup request |
Sample Response (Success):
HTTP Code : 200
{
"status":{
"state":"SUCCESS"
},
"result":{
"entityType":"STANDARD",
"searchInfo":{
"numberOfElements":"2",
"numberOfPages":"1"
},
"data":[
{
"locale":"en",
"name":"SCS Indoor Advantage",
"code":"SCS Indoor Advantage",
"standardProperties":[
{
"name": "Level",
"code": "SCS_IAQ_LEVEL"
}
]
},
{
"locale":"en",
"name":"NSF/ANSI 347 – 2012 Multi-attribute Sustainability Certification",
"code":"NSF/ANSI 347 – 2012"
}
]
},
"connectRequest":{
"locale":"en",
"pageNumber":"1",
"pageSize":"2",
"searchCriteria": [
{
"name": "KEYWORD",
"value": "*"
},
{
"name": "STANDARDTYPE",
"value": "STANDARD"
}
]
}
}
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]"
"Request has invalid value 'STD' for field standardType. Allowed value(s) : [LABEL,STANDARD,TESTREPORT]"
]
},
"connectRequest": {
"locale": "es",
"searchCriteria": [
{
"name": "KEYWORD",
"value": "*"
},
{
"name": "STANDARDTYPE",
"value": "STD"
}
]
}
}