Streamlinq Shipments & Waste Volumes APIs
Overview ¶
Welcome to the Streamlinq API section of the Wastelinq API suite. This collection of APIs is specifically designed to manage and interact with Streamlinq data within the Wastelinq system.
The Streamlinq API provides functionalities such as creating, updating, retrieving, and deleting Streamlinq data. It allows for efficient management of Streamlinq data, enabling seamless integration with other systems or services.
Each API endpoint in this section corresponds to a unique functionality related to Streamlinq. The response from each API call includes specific fields and data types, providing detailed information about the Streamlinq data.
For comprehensive documentation of each API, follow the respective link provided in the APIs section.
For more detailed information on the structure of requests and responses, please refer to the individual API sections.
Bearer Token
A bearer token is a type of access token that is used for authorization in APIs. It is a cryptic string that is generated by the server in response to a login request. The client must send this token in the Authorization header when making requests to protected resources.
The “Bearer” keyword is a signal to the server that the token is a type of bearer token. Here’s an example of how to use it:
Authorization: Bearer <Your-Bearer-Token>
Replace
For example:
Authorization: Bearer 5262d64b892e8d4341000001
Error Messages
-
400 Bad Request: This error is returned when the server could not understand the request due to invalid syntax. Check your request body and parameters. -
401 Unauthorized: This error is returned when the request lacks valid authentication credentials for the target resource. Make sure your API key is correct. -
403 Forbidden: This error is returned when the server understood the request, but it refuses to authorize it. This status is often returned if you’re missing permissions to access the resource. -
404 Not Found: This error is returned when the server can’t find the requested resource. Check your endpoint and parameters. -
500 Internal Server Error: This error is returned when the server encounters an unexpected condition that prevented it from fulfilling the request.
APIs ¶
Aggregated Data ¶
Aggregated DataPOST/api/streamlinq/manifests/aggregated_data/
Overview:
Retrieve data from the database and calculate it to load into the MANIFESTS SHIPPED, TOTAL WASTE (TONS), TOTAL CONTAINERS, and TOTAL MANIFEST WASTE LINES boxes.
Response Description:
| Name | Data Type | Description |
|---|---|---|
| total_waste | number | The total quantity of waste managed |
| shipped_count | number | This is the total number of shipments that were made |
| container_count | number | The total number of containers used to handle the waste |
| waste_streams | number | The total number of distinct waste streams |
Example URI
Headers
Content-Type: application/json
Authorization: {TOKEN}Body
{
"filterFields": {},
"searchKey": ""
}200Headers
Content-Type: application/jsonBody
{
"total_waste": " 112,316,288.68",
"shipped_count": " 8,846,131",
"container_count": " 69,367,493",
"waste_streams": " 21,692,747"
}Manifest # ¶
Manifest #POST/api/streamlinq/manifests/
Overview:
Retrieve data from the database to load into the Manifest # table.
Response Description:
| Name | Data Type | Description |
|---|---|---|
| totalElements | number | Total number of shipment records |
| content | array | Array of shipment record objects |
| manifest_tracking_number | string | Unique shipment identifier |
| generator_name | string | Name of waste generator |
| transporter | string | Company transporting waste |
| designated_facility_name | string | Facility receiving waste |
| shipped_date | string | Date waste was shipped |
| received_date | string | Date waste was received |
| total_waste_quantity_tons | number | Total tons of waste in shipment |
| container_count | number | Number of containers |
| waste_stream_count | number | Number of different waste streams |
| generator_location_state | string | Generator’s state |
| generator_epa_id | string | Generator’s EPA ID |
| waste_lines | array | Array of individual waste lines |
| manifest_tracking_number | string | Unique shipment identifier |
| waste_line_number | number | Line item number for waste stream |
| usdot_haz_indicator | string | Hazmat flag for transportation |
| usdot_id_number | string | UN ID number for material |
| usdot_desc | string | Description for transport |
| container_count | string | Number of containers for this waste |
| container_type_code | string | Container type code |
| epa_waste_indicator | string | EPA hazardous waste flag |
| waste_quantity_tons | number | Tons of this waste in shipment |
| transporter | string | Transporter company |
| federal_waste_codes | string | Applicable EPA waste codes |
| mmc_and_desc | string | Management method and description |
Example URI
Headers
Content-Type: application/json
Authorization: {TOKEN}Body
{
"filterFields": {
"generator_names": ["Company A"],
"transporter_names": ["Company B"],
"designated_facility_names": ["Company C"],
"dot_id_nos": ["NA3077"],
"container_types": ["CM"],
"handling_codes": ["H050"],
"shipped_date_end": "2021-03-05",
"shipped_date_start": "2021-03-05",
"received_date_end": "2021-03-10",
"received_date_start": "2021-03-10",
},
"pageInfo": {
"page": 0,
"pageSize": 10,
"filters": "all=",
"selectedFields": "manifest_tracking_number,generator_name,transporter,designated_facility_name,shipped_date,received_date,total_waste_quantity_tons,container_count,waste_stream_count,generator_location_state",
"sort": "epa_handler_id asc"
},
"searchKey": "Company A"
}200Headers
Content-Type: application/jsonBody
{
"totalElements": 8846131,
"content": [
{
"manifest_tracking_number": "10000",
"generator_name": "Company A",
"transporter": "Company B",
"designated_facility_name": "Company C",
"shipped_date": "2021-03-05",
"received_date": "2021-03-10",
"total_waste_quantity_tons": 5.05,
"container_count": 1,
"waste_stream_count": 1,
"generator_location_state": "IL",
"generator_epa_id": "10000",
"waste_lines": [
{
"manifest_tracking_number": "10000",
"waste_line_number": 1,
"usdot_haz_indicator": "Y",
"usdot_id_number": "NA3077",
"usdot_desc": "RQ, NA3077, HAZARDOUS WASTE, SOLID, N.O.S. (CADMIUM, LEAD) 9, PG III",
"container_count": "1",
"container_type_code": "CM",
"epa_waste_indicator": "Y",
"waste_quantity_tons": 5.05,
"transporter": "10000",
"federal_waste_codes": "D006,D008",
"mmc_and_desc": "H050 - ENERGY RECOVERY"
}
]
}
]
}Manifest # Filter Box ¶
Manifest # Filter BoxGET/api/streamlinq/shipments_and_waste_volumes/filters/?field=manifest_number&page=1&search=
Overview:
Retrieve data from the database to load into the Manifest # Filter Box.
Response Description:
| Name | Data Type | Description |
|---|---|---|
| results | array | Array containing result objects |
| value | string | The value of each result |
| text | string | Display text for each result |
| pagination | object | Object with pagination metadata |
| more | boolean | Indicates if more pages exist |
Example URI
- field
string(required) Example: manifest_numberThe manifest number
- page
number(required) Example: 1The page number for pagination
- search
string(optional) Example: ""The search query
Headers
Content-Type: application/json
Authorization: {TOKEN}200Headers
Content-Type: application/json
Authorization: {TOKEN}Body
{
"results": [
{
"value": "000000000FLE",
"text": "000000000FLE"
}
],
"pagination": {
"more": true
}
}Generator Name Filter Box ¶
Generator Name Filter BoxGET/api/streamlinq/shipments_and_waste_volumes/filters/?field=generator_name&page=1&search=
Overview:
Retrieve data from the database to load into the Generator Name Filter Box.
Response Description:
| Name | Data Type | Description |
|---|---|---|
| results | array | Array containing result objects |
| value | string | The value of each result |
| text | string | Display text for each result |
| pagination | object | Object with pagination metadata |
| more | boolean | Indicates if more pages exist |
Example URI
- field
string(required) Example: generator_nameThe name of the generator
- page
number(required) Example: 1The page number for pagination
- search
string(optional) Example: ""The search query
Headers
Content-Type: application/json
Authorization: {TOKEN}200Headers
Content-Type: application/json
Authorization: {TOKEN}Body
{
"results": [
{
"value": "Company A",
"text": "Company A"
}
],
"pagination": {
"more": true
}
}Transporter Name Filter Box ¶
Transporter Name Filter BoxGET/api/streamlinq/shipments_and_waste_volumes/filters/?field=transporter_name&page=1&search=
Overview:
Retrieve data from the database to load into the Transporter Name Filter Box.
Response Description:
| Name | Data Type | Description |
|---|---|---|
| results | array | Array containing result objects |
| value | string | The value of each result |
| text | string | Display text for each result |
| pagination | object | Object with pagination metadata |
| more | boolean | Indicates if more pages exist |
Example URI
- field
string(required) Example: transporter_nameThe name of the transporter
- page
number(required) Example: 1The page number for pagination
- search
string(optional) Example: ""The search query
Headers
Content-Type: application/json
Authorization: {TOKEN}200Headers
Content-Type: application/json
Authorization: {TOKEN}Body
{
"results": [
{
"value": "000390428",
"text": "000390428"
}
],
"pagination": {
"more": true
}
}Designated Facility Name Filter Box ¶
Designated Facility Name Filter BoxGET/api/streamlinq/shipments_and_waste_volumes/filters/?field=designated_facility_name&page=1&search=
Overview:
Retrieve data from the database to load into the Designated Facility Name Filter Box.
Response Description:
| Name | Data Type | Description |
|---|---|---|
| results | array | Array containing result objects |
| value | string | The value of each result |
| text | string | Display text for each result |
| pagination | object | Object with pagination metadata |
| more | boolean | Indicates if more pages exist |
Example URI
- field
string(required) Example: designated_facility_nameThe name of the designated facility
- page
number(required) Example: 1The page number for pagination
- search
string(optional) Example: ""The search query
Headers
Content-Type: application/json
Authorization: {TOKEN}200Headers
Content-Type: application/json
Authorization: {TOKEN}Body
{
"results": [
{
"value": "LIGHTING RESOURCES",
"text": "LIGHTING RESOURCES"
}
],
"pagination": {
"more": true
}
}DOT ID No Filter Box ¶
DOT ID No Filter BoxGET/api/streamlinq/shipments_and_waste_volumes/filters/?field=dot_id_no&page=1&search=
Overview:
Retrieve data from the database to load into the DOT ID No Filter Box.
Response Description:
| Name | Data Type | Description |
|---|---|---|
| results | array | Array containing result objects |
| value | string | The value of each result |
| text | string | Display text for each result |
| pagination | object | Object with pagination metadata |
| more | boolean | Indicates if more pages exist |
Example URI
- field
string(required) Example: dot_id_noThe DOT ID number
- page
number(required) Example: 1The page number for pagination
- search
string(optional) Example: ""The search query
Headers
Content-Type: application/json
Authorization: {TOKEN}200Headers
Content-Type: application/json
Authorization: {TOKEN}Body
{
"results": [
{
"value": "ID8000",
"text": "ID8000"
}
],
"pagination": {
"more": true
}
}Container Type Filter Box ¶
Container Type Filter BoxGET/api/streamlinq/shipments_and_waste_volumes/filters/?field=container_type&page=1&search=
Overview:
Retrieve data from the database to load into the Container Type Filter Box.
Response Description:
| Name | Data Type | Description |
|---|---|---|
| results | array | Array containing result objects |
| value | string | The value of each result |
| text | string | Display text for each result |
| pagination | object | Object with pagination metadata |
| more | boolean | Indicates if more pages exist |
Example URI
- field
string(required) Example: container_typeThe type of the container
- page
number(required) Example: 1The page number for pagination
- search
string(optional) Example: ""The search query
Headers
Content-Type: application/json
Authorization: {TOKEN}200Headers
Content-Type: application/json
Authorization: {TOKEN}Body
{
"results": [
{
"value": "BA",
"text": "BA"
}
],
"pagination": {
"more": true
}
}Handling Code Filter Box ¶
Handling Code Filter BoxGET/api/streamlinq/shipments_and_waste_volumes/filters/?field=handling_code&page=1&search==
Overview:
Retrieve data from the database to load into the Handling Code Filter Box.
Response Description:
| Name | Data Type | Description |
|---|---|---|
| results | array | Array containing result objects |
| value | string | The value of each result |
| text | string | Display text for each result |
| pagination | object | Object with pagination metadata |
| more | boolean | Indicates if more pages exist |
Example URI
- field
string(required) Example: handling_codeThe handling code
- page
number(required) Example: 1The page number for pagination
- search
string(optional) Example: ""The search query
Headers
Content-Type: application/json
Authorization: {TOKEN}200Headers
Content-Type: application/json
Authorization: {TOKEN}Body
{
"results": [
{
"value": "H010",
"text": "H010"
}
],
"pagination": {
"more": true
}
}Generator Details ¶
Generator DetailsGET/api/streamlinq/generators/details/?handler_id=10000
Overview:
Retrieve data from the database to load into the Generator Details pop-up.
Response Description:
| Name | Data Type | Description |
|---|---|---|
| generator_data | object | Object containing generator data |
| epa_handler_id | string | The facility’s EPA identification number |
| generator_name | string | Name of the waste generator/facility |
| mail_street_number, mail_street_1, mail_street_2, mail_city, mail_zip, mail_state | string | Mailing address fields for the facility |
| physical_address | string | Physical location address of the facility |
| location_street_number, location_street_1, location_street_2, location_city, location_zip, location_state | string | Physical location address fields |
| contact_name | string | Contact person name |
| contact_email | string | Contact email address |
| contact_phone_number | string | Contact phone number |
| primary_naics_code | string | North American Industry Classification System code |
| primary_naics_desc | string | Description of primary NAICS code |
| total_generated_waste | number | Total amount of waste generated (tons) |
| total_container | number | Number of containers/shipments |
| total_mmc | number | Total management method codes used |
| total_shipped | number | Amount of waste shipped off-site (tons) |
| shipped_years | string | Year(s) waste was shipped |
| federal_generator_status_universe | string | The facility’s status according to federal regulations (e.g. Large Quantity Generator) |
| land_type | string | Type of land the facility is located on (e.g. industrial, residential) |
| short_term_generator_activity | string | Indicates if the facility engages in short-term or episodic hazardous waste generation |
| mixed_waste_generator | string | Indicates if the facility generates mixed (hazardous and radioactive) wastes |
| transporter_activity | string | Indicates if the facility transports hazardous waste |
| transfer_facility_activity | string | Indicates if the facility is a hazardous waste transfer facility |
| importer_activity | string | Indicates if the facility imports hazardous waste |
| federal_waste_codes | string | The hazardous waste codes that apply to the facility’s waste streams |
| management_method_code | string | The primary management method used for the facility’s hazardous waste |
| full_address | string | The complete physical address of the facility |
| location_latitude, location_longitude | string | GPS coordinates of the facility location |
| public_notes | string | Any public notes about the facility |
| managed_waste, shipped_waste, received_waste | number | Amounts of waste managed/shipped/received annually (tons) |
| registration_status | string | The facility’s registration status |
| is_industry | string | Indicates if the facility is classified as industrial |
| state_handler_id | string | The facility ID assigned by the state (if applicable) |
| federal_generator_status_universe_code | string | Code for the facility’s federal generator status |
| mailing_address | string | The facility’s mailing address |
| type_data | object | Object containing type data |
| short_term_generator_activity | string | Indicates if facility engages in short-term/episodic generation |
| mixed_waste_generator | string | Indicates if facility generates mixed (hazardous and radioactive) wastes |
| transporter_activity | string | Indicates if facility transports hazardous waste |
| transporter_facility_activity | string | Indicates if facility is a hazardous waste transporter facility |
| importer_activity | string | Indicates if facility imports hazardous waste |
| site_activities | object | Object containing site data |
| report_year | string | Year waste data applies to |
| generated_waste | string | Amount of waste generated (tons) |
| managed_waste | number | Amount of waste managed on-site (tons) |
| shipped_waste | number | Amount of waste shipped off-site (tons) |
| received_waste | number | Amount of waste received from other facilities (tons) |
| waste_code_data | array | Array containing waste code and description |
| D001 | string | Hazardous waste code and description |
| mmc_codes | array | Array containing mmc and description |
| management_method | string | Code for primary management method |
| management_method_description | string | Description of management method |
| naics_codes | array | Array of NAICS codes associated with the facility |
| naics_code | string | The NAICS code number |
| naics_desc | string | Description of the NAICS code |
| is_active | string | Indicates if the NAICS code is currently active for the facility (“Y” or “N”) |
| sic_codes | array | Array of SIC codes associated with the facility |
| sic_code | number | The SIC code number |
| sic_desc | string | Description of the SIC code |
| gen_map | string | Embedded map of the facility location |
| is_network | boolean | Indicates if facility is part of a network |
| is_streamlinq_enable | boolean | Indicates StreamlinQ feature status |
Example URI
- handler_id
string(required) Example: 10000The handler ID
Headers
Content-Type: application/json
Authorization: {TOKEN}200Headers
Content-Type: application/json
Authorization: {TOKEN}Body
{
"generator_data": {
"epa_handler_id": "10000",
"generator_name": "Company A",
"mail_street_number": "132",
"mail_street_1": "My Street",
"mail_street_2": "My Street",
"mail_city": "Kingston",
"mail_zip": "12401",
"mail_state": "NY",
"physical_address": "132, My Street, Kingston, New York 12401.",
"location_street_number": "132",
"location_street_1": "132",
"location_street_2": "132",
"location_city": "Kingston",
"location_zip": "12401",
"location_state": "NY",
"contact_name": "Jane Doe",
"contact_email": "janedoe@test.com",
"contact_phone_number": "100-100-1000",
"primary_naics_code": "",
"primary_naics_desc": "",
"total_generated_waste": 0.2,
"total_container": 2,
"total_mmc": 2,
"total_shipped": 1,
"shipped_years": "2023",
"federal_generator_status_universe": "N/A - Not Applicable",
"land_type": "N/A",
"short_term_generator_activity": "",
"mixed_waste_generator": "",
"transporter_activity": "",
"transfer_facility_activity": "",
"importer_activity": "",
"federal_waste_codes": "D001",
"management_method_code": "H141",
"full_address": "132, My Street, Kingston, New York 12401.",
"location_lattitude": "N/A",
"location_longitude": "N/A",
"public_notes": "",
"managed_waste": 0,
"shipped_waste": 0,
"recieved_waste": 0,
"registration_status": "N/A",
"is_industry": "No",
"state_handler_id": "",
"federal_generator_status_universe_code": "",
"mailing_address": " 132, My Street, Kingston, New York 12401."
},
"type_data": {
"short_term_generator_activity": "No",
"mixed_waste_generator": "No",
"transporter_activity": "No",
"transporter_facility_activity": "No",
"importer_activity": "No"
},
"site_activities": {
"report_year": "2023",
"generated_waste": "0.20",
"managed_waste": 0,
"shipped_waste": 0,
"received_waste": 0
},
"waste_code_data": {
"D001": "IGNITABLE WASTE"
},
"mmc_codes": [
{
"management_method": "H141",
"management_method_description": "STORAGE, BULKING AND/OR TRANSFER OFF SITE"
}
],
"naics_codes": [
{
"naics_code": "11111",
"naics_desc": "SOYBEAN FARMING",
"is_active": "Y"
}
],
"sic_codes": [
{
"sic_code": 5311,
"sic_desc": "Department Stores"
}
],
"gen_map": "example",
"is_network": false,
"is_streamlinq_enable": false
}