openapi: 3.0.0 info: version: 1.2.1 title: Emerge Public API description: 'The Emerge public API provides partner developers with access to core capabilities of the Emerge platform. The current version of the API is v1.2.1. This API will evolve as the features in Emerge''s product evolve. # Get Started The Emerge API is a ''restish'' API and is designed to allow you to work with objects using familiar HTTP verbs like * POST * PUT * DELETE * GET All production level API requests are made to:
`https://api.emergemarket.io` The testing sandbox is available during development and for testing:
`https://demo-api.emergemarket.dev/` ## Compatibility Policy Emerge APIs are versioned using a prefix in the endpoint URL. Within an API version, we only make backward-compatible changes. This mean that when a provider integrates with our REST API, the API will continue to work until the version is deprecated. If we have to create a change that is not compatible with the current version, a new version will be created. ### Non-Breaking Changes * Adding additional optional fields on the API request. * Adding additional fields on the API response. * Adding an HTTP method to an API. * Adding optional headers. * Adding additional accepted enumerated values. * Changing Error Response descriptions. * Added Rate Limits. ### Breaking Changes * Removing or renaming an API method or endpoint. * Removing or renaming existing API request or response fields. * Removing or renaming enumerated values. * Changing the Error Response values. ### Deprecation Policy * Emerge will continue to support deprecated APIs for 1 year. * Documentation will also be updated and integrating providers will be notified via email when a version or endpoint is being deprecated. # Workflows The Emerge API is designed to support two primary workflows for a shipper organization: An opportunity-to-tender workflow and an opportunity-to-award workflow. ## Opportunity-to-tender The opportunity-to-tender is the most common workflow of an integrating system. In this workflow, the Emerge system is used to source the live capacity as well as to tender through Emerge to that live capacity. The benefit of this workflow is that all information, from opportunity through tender and finally tracking is maintained in the Emerge system. The basic steps of this workflow include: 1. Create an Opportunity. 2. Post to the shipper''s (your) marketplace. 3. Receive options from carriers. Retrieval is achieved through a webhook published by you for receiving option events. 4. Tender to a carrier. 5. Get tracking updates through webhook. ## Opportunity-to-award The opportunity-to-award workflow supports customers who are using the Emerge platform in conjunction with their TMS. In this workflow, Emerge is used as a capacity provider while the TMS is used on the execution side. The basic steps of this workflow include: 1. Create an opportunity. 2. Post to the shipper''s (your) marketplace. 3. Receive options from carriers. Retrieval is achieved through a webhook published by you for receiving option events. 4. Award to a carrier. Note that awarding to the carrier will automatically close the opportunity, notify the carrier that they "won" the bidding and notify the remaining carriers that they did not win the bidding. The opportunity-to-award workflow requires that the customer''s TMS tenders to the winning carrier. This happens outside of the Emerge system. ' servers: - url: https://api.emergemarket.io/v1 description: Primary production endpoint - url: https://demo-api.emergemarket.dev/v1 description: Testing sandbox endpoint tags: - name: Webhooks description: "Webhooks are used to provide updates to the TMS when award or option events are generated within the Emerge\ \ system.\n

If our webhook message cannot be accepted by the webhook endpoint due to network failures, server\ \ errors, or request timeouts we will attempt delivering the message again. We will retry sending the message 6 times\ \ with varying gaps of time. \nSee table below:\n\n\n\n\n\n\n\n\ \n\n\n\n\n\n\n\ \n\n\n\n\n\n\ \n\n\n\n\n\n\n\n\ \n
Retry CountTime
11 second from initial attempt
24 seconds from first attempt
39 seconds from second attempt
416 seconds from third attempt
525 seconds from fourth attempt
636 seconds from fifth attempt
\t\t\n" - name: Tracking Events description: "The tracking events share a common object structure with the exception of ‘event_data’ object, which can change\ \ slightly depending on the updates.\n# Delivery Status Updated Event\n

delivery_status_updated

\n The delivery\ \ status is the on-time status of a shipment. In the event that this changes from one status to another the user can be\ \ notified (for example on-time to late, etc). This can be driven by the ETA being updated or the actual arrival/departure\ \ being updated. The old state will be an empty object if there was no previous data (on creation). \n\n\n# Tracking Status Updated Event\n

tracking_status_updated

\n\ \ The shipment status is the primary status of the shipment. This determines the shipments progress from tender accepted\ \ > delivered. The old state will be an empty object if there was no previous data (on creation). \n\n\n# Stop Actual Times Updated Event\n

stop_actual_times_updated\ \

\n The user can be notified via this event when an actual arrival or departure information is received in the\ \ Emerge system. The old state will be an empty object if there was no previous data (on creation). \n\n\n# Current Location Updated Job Event\n

current_location_updated_job\ \

\n Emerge will send the most recent location of the truck every 30 minutes. The old state will be an empty object\ \ if there was no previous data (on creation). \n\n" - name: Opportunity Awarded Event description: "

opportunity_awarded

\nThis object contains details of the Awarded option, so that the subscriber can\ \ do the subsequent actions, including tendering to it, in their own TMS.\n \n" - name: Options Changed Event description: "

options_changed

\nThis object contains the list of all the options available for a particular opportunity.\ \ Showing all options or the lowest option can be controlled in the application setting. Whenever there is a change in\ \ the available option(s), this event will get triggered and notify the subscribers.\n \n" - name: Tender Status Updated Event description: "

tender_status_updated

\nThis object contains the tender details. Whenever there is a change in the\ \ tender status, this event will get triggered and notify the subscribers.\n \n" - name: Network Partner Updated Event description: "

network_partner_updated

\nThis object contains the partner details. Whenever the partner registers\ \ on Emerge platform following an invite by a shipper,or there is a change in the partner details, this event will get\ \ triggered and notify the subscribers\n \n" - name: Network Partner Deleted Event description: "

network_partner_deleted

\nThis object contains the partner details. When the partner is deleted then\ \ this event will get triggered and notify the subscribers.\n \n" - name: Current Marketplace Option Event description: "

current_marketplace_option

\nThis object contains the Current Marketplace Option. Whenever there\ \ is a change in the Marketplace Option details this event will get triggered and notify the subscribers.\n \n" - name: Opportunity Deleted Event description: "

opportunity_deleted

\nThis object contains an opportunity identifier and references. When an opportunity\ \ is deleted then this event will get triggered and notify the subscribers.\n \n" - name: Opportunity Not Awarded Event description: "

opportunity_not_awarded

\nThis object contains an opportunity identifier and references. When an\ \ opportunity is not awarded at the end of the bid duration then this event will get triggered and notify the subscribers.\n\ \ \n" x-tagGroups: - name: Shipper API tags: - Authentication - Network Partners - Opportunities - Options - Awards - Tenders - Shipments - name: Webhook Subscription API tags: - Webhooks - name: Webhook Events tags: - Tracking Events - Opportunity Awarded Event - Opportunity Deleted Event - Opportunity Not Awarded Event - Options Changed Event - Tender Status Updated Event - Network Partner Updated Event - Network Partner Deleted Event - Current Marketplace Option Event paths: /auth/login: post: tags: - Authentication summary: Gets access token for shipper user. security: [] description: This method allows the shipper user to generate an access token from Emerge platform. This access token is based upon a username/password combination that should be supplied in the request. Authentication has a rate limit of up to 20 requests per second. This limit may be lower during times of high volumes. requestBody: description: Request body of an authentication attempt. required: true content: application/json: schema: type: object properties: user_name: description: The user name of the user authenticating against the API. type: string example: jsseh@emergemarket.com password: description: The password of the user authenticating against the API. type: string example: Secret123 required: - user_name - password responses: '200': description: 200 | OK. A JSON object containing the access token and additional information. content: application/json: schema: $ref: '#/components/schemas/200_authentication_response' '403': $ref: '#/components/responses/403' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' /auth/refresh: post: tags: - Authentication summary: Gets a refreshed access token for shipper user. security: [] description: This method allows users to refresh their access token based upon the original authentication event. requestBody: description: Request of the authentication renewal attempt. required: true content: application/json: schema: type: object properties: refresh_token: description: The refresh token from the original authentication request. type: string example: asdfklwj43asdfja432sjdafjadkkj2345efsdk4ts required: - refresh_token responses: '200': description: 200 | OK. A new access token has been generated. content: application/json: schema: $ref: '#/components/schemas/200_authenticationrefresh_response' '400': description: 400 | Bad Request. A bad request was made. Please try again content: application/json: schema: $ref: '#/components/schemas/400_badrequest_refreshtoken_response' '403': $ref: '#/components/responses/403' /network_partners: description: This endpoint allows a shipper organization to interact with it's network partners (capacity providers) that are defined in the Emerge Platform. get: parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string tags: - Network Partners summary: Gets all active network partners associated with the shipper organization. security: - BearerAuth: [] description: This method gives the ability to a shipper organization to view its active network partners in the Emerge system. responses: '200': description: 200 | OK. Returns the list of associated active network partners. content: application/json: schema: $ref: '#/components/schemas/200_getnetworkpartner_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' post: parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string tags: - Network Partners summary: Invites a network partner to Emerge platform. security: - BearerAuth: [] description: This method gives the ability to the shipper organization to invite it's network partner to the Emerge platform. requestBody: description: Request model to invite a network partner. required: true content: application/json: schema: type: object properties: contact: type: object required: - first_name - last_name - email - phone properties: first_name: description: First name of the network partner contact. type: string example: mycarrier last_name: description: Last name of the network partner contact. type: string example: test email: description: Email id of the network partner contact. type: string format: email example: mycarrier.test@abc.com phone: description: Phone number of the network partner contact. $ref: '#/components/schemas/phone_request_object' partner_code: description: Network partner's partner code. Supports upto 10 characters with only uppercase and numeric values allowed. type: string example: AS1234 responses: '200': description: 200 | Success. Network partner invited successfully. content: application/json: schema: $ref: '#/components/schemas/200_invitenetworkpartner_response' '400': description: 400 | Bad Request. A bad request was made. Please try again content: application/json: schema: $ref: '#/components/schemas/400_badrequest_networkpartner_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' /network_partners/{partner_id}: delete: tags: - Network Partners summary: Deletes a network partner from Emerge platform. description: This method gives the ability to a shipper organization to delete it's network partner from the Emerge platform. security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: partner_id schema: type: integer minimum: 1 example: 1120 required: true description: ID of the network partner. responses: '200': description: 200 | OK. Network partner deleted. content: application/json: schema: $ref: '#/components/schemas/errorcode_zero_without_message_object' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' /opportunities: parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string post: tags: - Opportunities summary: Creates an opportunity. security: - BearerAuth: [] description: Creates an opportunity, also called a quote, in the system. Emerge recommends that the call provides a pickup date to ensure that this opportunity can be posted to the marketplace. requestBody: description: Structure of the call to create an opportunity required: true content: application/json: schema: $ref: '#/components/schemas/create_opportunity_request_object' responses: '200': description: 200 | Success. A new opportunity has been created and an opportunity object is returned content: application/json: schema: $ref: '#/components/schemas/201_createopportunity_response' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' get: tags: - Opportunities summary: Retrieves the details of opportunities by Reference Numbers security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: query name: references.customer schema: type: string example: CustRef123 description: 'Reference Number of the opportunity
Keys: references.customer references.trailer references.pro references.pickupconfirmation references.pickup references.bol references.appointment references.delivery references.other references.po ' responses: '200': description: 200 | OK. Returns the matching opportunities content: application/json: schema: $ref: '#/components/schemas/200_getopportunities_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' /opportunities/{opportunity_id}: get: tags: - Opportunities summary: Retrieves the details of an opportunity by ID security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: opportunity_id schema: type: integer minimum: 1 example: 112020 required: true description: ID of the opportunity responses: '200': description: 200 | OK. Returns the current opportunity content: application/json: schema: $ref: '#/components/schemas/200_getopportunity_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' delete: tags: - Opportunities summary: Deletes an opportunity by opportunity ID. description: Deletes an opportunity using the opportunity ID. security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: opportunity_id schema: type: integer minimum: 1 example: 112020 required: true description: ID of the opportunity responses: '200': description: 200 | OK. Opportunity deleted content: application/json: schema: $ref: '#/components/schemas/errorcode_zero_without_message_object' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' put: tags: - Opportunities summary: Updates an opportunity by ID. security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: opportunity_id schema: type: integer minimum: 1 example: 112020 required: true description: ID of the opportunity requestBody: description: Structure of the call to create an opportunity required: true content: application/json: schema: $ref: '#/components/schemas/update_opportunity_request_object' responses: '200': description: 200 | OK. Returns the current opportunity content: application/json: schema: $ref: '#/components/schemas/200_updateopportunity_response' '400': $ref: '#/components/responses/400' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' /opportunities/{opportunity_id}/post_to_marketplace: post: tags: - Opportunities summary: Posts an opportunity to the Emerge marketplace. description: This method gives the ability to a shipper organization to post an opportunity to the Emerge marketplace. security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: opportunity_id schema: type: integer minimum: 1 example: 112020 required: true description: ID of the opportunity responses: '200': description: 200 | OK. Successfully posted to the Emerge marketplace. content: application/json: schema: type: object properties: error: type: object properties: code: type: integer example: 0 '400': description: 400 | Bad Request. A bad request was made. Please try again content: application/json: schema: $ref: '#/components/schemas/400_badrequest_opportunitypost_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' /opportunities/{opportunity_id}/unpost_from_marketplace: post: tags: - Opportunities summary: Unposts an opportunity from the Emerge marketplace. description: This method gives the ability to a shipper organization to unpost an opportunity from the Emerge marketplace. security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: opportunity_id schema: type: integer minimum: 1 example: 112020 required: true description: ID of the opportunity responses: '200': description: 200 | OK. Successfully unposted from the Emerge marketplace content: application/json: schema: type: object properties: error: type: object properties: code: type: integer example: 0 '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' /opportunities/{opportunity_id}/options: description: Retrieves all the network partner options and market place options. get: tags: - Options summary: Gets options for an opportunity. security: - BearerAuth: [] description: Gets all network partner options and market place options for a specific opportunity. parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: opportunity_id schema: type: integer minimum: 1 example: 23892343 required: true description: Id of the opportunity responses: '200': description: 200 | OK. Returns the all network partners and marketplace options for a corresponding opportunity content: application/json: schema: $ref: '#/components/schemas/200_Alloptions_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' /opportunities/{opportunity_id}/post_to_network_partners: description: This method gives the ability to a shipper organization to post an opportunity to its network partners (capacity providers). post: tags: - Opportunities summary: Posts an opportunity to shipper's network partners. security: - BearerAuth: [] description: This method gives the ability to a shipper organization to post an opportunity to its network partners (capacity providers). parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: opportunity_id schema: type: integer minimum: 1 example: 112020 required: true description: Id of the opportunity requestBody: description: Request model to post an opportunity to selected network partners. required: true content: application/json: schema: type: object properties: post_to_all: type: boolean description: Use this flag to control to whom the request needs to be posted. If set as true, system will post request to all the network partners ignoring the other two fields. If set as false, it becomes mandatory to input values in either partner_ids or partner_codes field. If the request payload is sent with input in both partner_ids or partner_codes field, the system will merge both and post request to all the valid partners_ids and partner_codes. partner_codes: description: The list of codes of the selected network partners to whom the opportunity should be posted. type: array items: description: The network partner code. type: string example: - AS1234,X9898 partner_ids: description: The list of IDs of the selected network partners to whom the opportunity should be posted. type: array items: description: The network partner ID. type: string example: - 1111 - 9088 - 3456 responses: '200': description: 200 | OK. Details of the network partners to whom the request could not be sent. content: application/json: schema: type: object properties: response: $ref: '#/components/schemas/200_sendrequest_partners_response' error: type: object properties: code: description: HTTP code type: integer example: 0 '400': description: 400 | Bad Request. A bad request was made. Please try again content: application/json: schema: $ref: '#/components/schemas/400_badrequest_opportunity_notification_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' /opportunities/by_customer_reference/{customer_reference_number}: delete: tags: - Opportunities summary: Deletes an opportunity by customer reference number. description: Delete an opportunity using the Customer Reference Number. If there are multiple matches for the Customer Reference number, all open opportunities with that Customer Reference number will be deleted. security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: customer_reference_number schema: type: string required: true description: Customer reference number. responses: '200': description: 200 | OK. Opportunities deleted content: application/json: schema: $ref: '#/components/schemas/errorcode_zero_without_message_object' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' /awards: description: The award endpoints allow a shipper to award a carrier in the Emerge system a load. Note that awards are not replacements for tenders. The awards endpoints are typically used when the Emerge system is used to source capacity, while the shipper's TMS is used to tender to the carrier. summary: Returns an array of awards. get: tags: - Awards summary: Returns an array of awards. security: - BearerAuth: [] description: Returns a list of awards for a particular account. An opportunity can have either an award or a shipment. parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: query name: opportunity_id schema: type: integer description: Emerge system identifier for the awarded opportunity. example: 344392 - in: query name: option_id schema: type: integer description: Emerge system identifier for the option associated with the awarded opportunity. example: 12545 - in: query name: customer_reference_number schema: type: string description: Customer's identifier to match the awarded opportunity on. example: 1212934 - in: query name: start_date schema: type: string description: Start of the date range within which the Awards should be searched. Supports yyyy-mm-dd format. example: '2021-10-28' - in: query name: end_date schema: type: string description: End of the date range within which the Awards should be searched. Supports yyyy-mm-dd format. example: '2021-10-30' responses: '200': description: 200 | OK. A JSON array of awards content: application/json: schema: type: object properties: response: type: array items: type: object properties: award_id: description: The id of the award. type: integer example: 238842 opportunity_id: description: The id of the awarded opportunity. type: integer example: 238842 partner_quote_reference: description: The quote reference number of the winning partner. type: string example: T12334 expiration_date: description: The expiration date of the winning option. type: string example: '2021-10-28T07:53:59.402' availability_date: description: The availability date of the winning option. type: string example: '2021-10-28T07:53:59.402' option_id: description: The id of the winning option. type: integer example: 123 rate: description: Rate of the winning option. type: number example: 300 is_total_rate: description: Indicates whether the rate contains fuel surcharge or not. type: boolean modified_date: description: Modified date of the winning option. type: string example: '2021-10-28T07:53:59.402' created_date: description: Created date of the winning option. type: string example: '2021-10-28T07:53:59.402' partner: $ref: '#/components/schemas/200_getawards_partner_response' notes: description: Notes on the award. type: string example: Lorem ipsum dolor sit amet, consectetur adipiscing elit. emerge_opportunity_reference: description: Emerge reference for the awarded opportunity. type: string example: Q11238842 references: $ref: '#/components/schemas/references_object' award_method: description: Award method for the awarded opportunity. type: string enum: - Manual - AutoAward - BookItNow example: Manual error: type: object properties: code: description: HTTP code type: integer example: 0 '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' post: parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string tags: - Awards summary: Creates an award. security: - BearerAuth: [] description: Creates an award. Awarding is the process of informing the carrier that they have won the shipment without tendering to them. requestBody: description: Request body of award required: true content: application/json: schema: type: object properties: option_id: description: The winning option id. type: integer example: 3233 not_awarding_to_lowest_option_reason_code: description: Reason code for not awarding to the lowest option, if applicable. type: string enum: - ContractedLane - ServiceLevel - Accountability - NoLongerAvailable - Other - NotProvided example: ContractedLane not_awarding_to_lowest_option_reason: description: Custom reason text for not awarding to the lowest option, when selected Reason Code is "Other". type: string example: The lowest option carrier is black listed in my organization. required: - option_id responses: '200': description: 200 | OK. A JSON award content: application/json: schema: type: object properties: response: type: object properties: award_id: description: The id of the award. type: integer example: 238842 opportunity_id: description: The id of the awarded opportunity. type: integer example: 238842 partner_quote_reference: description: The quote reference number of the winning partner. type: string example: test123 expiration_date: description: The expiration date of the winning option. type: string example: '2020-10-28T07:53:59.402Z' availability_date: description: The availability date of the winning option. type: string example: '2020-10-28T07:53:59.402' option_id: description: The id of the winning option. type: integer example: 123 rate: description: Rate of the winning option. type: number example: 300 is_total_rate: description: Indicates whether the rate contains fuel surcharge or not. type: boolean modified_date: description: Modified date of the winning option. type: string example: '2020-10-28T07:53:59.402Z' created_date: description: Created date of the winning option. type: string example: '2020-10-28T07:53:59.402Z' partner: $ref: '#/components/schemas/200_getawards_partner_response' notes: description: Notes on the award. type: string example: Lorem ipsum dolor sit amet, consectetur adipiscing elit. emerge_opportunity_reference: description: Emerge reference for the awarded opportunity. type: string example: Q11238842 references: $ref: '#/components/schemas/references_object' award_method: description: Award method for the awarded opportunity. type: string enum: - Manual - AutoAward - BookItNow example: Manual error: type: object properties: code: description: HTTP code type: integer example: 0 '400': description: 400 | Bad Request. A bad request was made. Please try again content: application/json: schema: $ref: '#/components/schemas/400_badrequest_createaward_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' /awards/{id}: description: The award endpoints allow a shipper to award a carrier in the Emerge system a load. Note that awards are not replacements for tenders. The awards endpoints are typically used when the Emerge system is used to source capacity, while the shipper's TMS is used to tender to the carrier. summary: Returns an award for award identifier. get: tags: - Awards summary: Retrieves the details of an award. security: - BearerAuth: [] description: Returns an award. An opportunity can have either an award or a shipment. parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: id schema: type: integer minimum: 1 example: 112020 required: true description: Id of the award responses: '200': description: 200 | OK. A JSON award content: application/json: schema: type: object properties: response: type: object properties: award_id: description: The id of the award. type: integer example: 238842 opportunity_id: description: The id of the awarded opportunity. type: integer example: 238842 partner_quote_reference: description: The quote reference number of the winning partner. type: string example: T12334 expiration_date: description: The expiration date of the winning option. type: string example: '2021-10-28T07:53:59.402Z' availability_date: description: The availability date of the winning option. type: string example: '2021-10-28T07:53:59.402' option_id: description: The id of the winning option. type: integer example: 123 rate: description: Rate of the winning option. type: number example: 300 is_total_rate: description: Indicates whether the rate contains fuel surcharge or not. type: boolean modified_date: description: Modified date of the winning option. type: string example: '2021-10-28T07:53:59.402Z' created_date: description: Created date of the winning option. type: string example: '2021-10-28T07:53:59.402Z' partner: $ref: '#/components/schemas/200_getawards_partner_response' notes: description: Notes on the award. type: string example: Lorem ipsum dolor sit amet, consectetur adipiscing elit. emerge_opportunity_reference: description: Emerge reference for the awarded opportunity. type: string example: Q11238842 references: $ref: '#/components/schemas/references_object' award_method: description: Award method for the awarded opportunity. type: string enum: - Manual - AutoAward - BookItNow example: Manual error: type: object properties: code: description: HTTP code type: integer example: 0 '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' /tenders: summary: Creates a tender description: Tenders allow the shipper to award the shipment to Emerge Transportation. The Marketplace workflow does allow Emerge to reject a tender. At this time, however, a rejected tender will be performed manually to ensure the best customer experience and to simplify the integration experience. post: parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string tags: - Tenders description: The opportunity_id must be included in the create tender call. summary: Creates a tender security: - BearerAuth: [] requestBody: description: Structure of the call to create the tender required: true content: application/json: schema: $ref: '#/components/schemas/tenders' responses: '200': description: 200 | Success. A new tender has been created and an tender object is returned content: application/json: schema: $ref: '#/components/schemas/201_createtender_response' '400': description: 400 | Bad Request. A bad request was made. Please try again content: application/json: schema: $ref: '#/components/schemas/400_badrequest_createtender_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' /tenders/{tender_id}: get: tags: - Tenders summary: Retrieves the details of a tender. description: Tenders allow the shipper to award the shipment to Emerge Transportation. The get tender endpoint allows a developer to retrieve a specific tender. security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: tender_id schema: type: integer minimum: 1 example: 112020 required: true description: ID of the tender responses: '200': description: 200 | OK. Returns the current tender. content: application/json: schema: $ref: '#/components/schemas/201_createtender_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' put: tags: - Tenders summary: Updates a tender. description: The shipment_id and rate value must be included in the update tender call. security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: tender_id schema: type: integer minimum: 1 example: 112020 required: true description: ID of the tender requestBody: description: Structure of the call to create the tender required: true content: application/json: schema: $ref: '#/components/schemas/tenders' responses: '200': description: 200 | OK. The tender has been updated and tender object is returned. content: application/json: schema: $ref: '#/components/schemas/201_createtender_response' '400': description: 400 | Bad Request. A bad request was made. Please try again content: application/json: schema: $ref: '#/components/schemas/400_badrequest_updatetender_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' /tenders/{tender_id}/cancel: post: tags: - Tenders summary: Cancel a tender. security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: tender_id schema: type: integer minimum: 1 example: 112020 required: true description: ID of the tender responses: '200': description: 200 | OK. The tender has been canceled. content: application/json: schema: $ref: '#/components/schemas/errorcode_zero_without_message_object' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '409': $ref: '#/components/responses/409' /shipments/{shipment_id}: get: tags: - Shipments summary: Get shipment. description: The Get Shipment end point allows shippers to get the full details of a shipment by it's ID. security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: shipment_id schema: type: integer minimum: 1 example: 12345 required: true description: ID of the shipment responses: '200': description: 200 | OK. Returns shipment details. content: application/json: schema: $ref: '#/components/schemas/200_getshipment_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' /webhooks: description: Webhooks are used to provide updates to the TMS when award or option events are generated within the Emerge system. post: parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string tags: - Webhooks summary: Create a new webhook. security: - BearerAuth: [] requestBody: description: Structure of the call to create the webhooks required: true content: application/json: schema: $ref: '#/components/schemas/webhooks' responses: '201': description: 201 | Success. A new webhook has been created and a webhook object is returned content: application/json: schema: $ref: '#/components/schemas/201_createwebhook_response' '400': description: 400 | Bad Request. A bad request was made. Please try again content: application/json: schema: $ref: '#/components/schemas/400_badrequest_webhook_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' get: parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string tags: - Webhooks summary: Get a list of all webhooks. security: - BearerAuth: [] responses: '200': description: 200 | OK. List of webhooks for the organization content: application/json: schema: $ref: '#/components/schemas/200_getwebhooks_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' /webhooks/{webhook_id}: get: tags: - Webhooks summary: Get the details of a webhook by Id. security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: webhook_id schema: type: string example: 2bc9eec8-0a66-4e0f-9103-ff4f6ad4ae68 required: true description: Identifier of the webhook responses: '200': description: 200 | OK. Webhook details content: application/json: schema: $ref: '#/components/schemas/200_getwebhook_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' put: tags: - Webhooks summary: Update an existing webhook. security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: webhook_id schema: type: string example: 2bc9eec8-0a66-4e0f-9103-ff4f6ad4ae68 required: true description: Identifier of the webhook requestBody: description: Structure of the call to update the webhook required: true content: application/json: schema: $ref: '#/components/schemas/updatewebhook' responses: '200': description: 200 | OK. The webhook has been updated content: application/json: schema: $ref: '#/components/schemas/errorcode_zero_without_message_object' '400': description: 400 | Bad Request. A bad request was made. Please try again content: application/json: schema: $ref: '#/components/schemas/400_badrequest_webhook_response' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' delete: tags: - Webhooks summary: Delete a webhook. security: - BearerAuth: [] parameters: - name: organization-id in: header description: The Organization GUID for the request. This Emerge provided value is only required if your integration user is in multiple organizations. Note that if multiple headers are passed, the organization from the first instance of the header will be used. example: - 070C895C-AE61-4629-A603-829FC54CD816 required: false schema: type: string - in: path name: webhook_id schema: type: string example: 2bc9eec8-0a66-4e0f-9103-ff4f6ad4ae68 required: true description: Identifier of the webhook responses: '200': description: 200 | OK. The webhook has been deleted content: application/json: schema: $ref: '#/components/schemas/errorcode_zero_without_message_object' '401': $ref: '#/components/responses/401' '403': $ref: '#/components/responses/403' '404': $ref: '#/components/responses/404' components: schemas: 200_authentication_response: type: object properties: response: type: object properties: token: description: The access token to be used in subsequent requests. type: string example: eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik9UYzROVFExTTBSRVF6SXhOamd6UVRZNU0wSkNRak5HTWpVNE5VTkVNa1l4TVROQk9VSkROQSJ9.eyJodHRwczovL2F1dGgwLmVtZXJnZXRtcy5jb20vVXNlcklkIjoiY2ViN2Q0ZWYtOTA1YS00MTlkLWFjMWUtZmQ0Y2IwMzc4MjEyIiwiaHR0cHM6Ly9hdXRoMC5lbWVyZ2V0bXMuY29tL09yZ2FuaXphdGlvbklkIjoiZWU3YmRjMGItOTFiMy00NDAwLWFmZjUtYzc3ZGZlMjk3NjA2IiwiaHR0cHM6Ly9hdXRoMC5lbWVyZ2V0bXMuY29tL1NoaXBtZW50UHJvdmlkZXJPcmdhbml6YXRpb25JZCI6ImVlN2JkYzBiLTkxYjMtNDQwMC1hZmY1LWM3N2RmZTI5NzYwNiIsImlzcyI6Imh0dHBzOi8vZW1lcmdlLXNzby10ZXN0LmF1dGgwLmNvbS8iLCJzdWIiOiJhdXRoMHw1ZGQ2OGNjYjRmOGZmNzAzYjI5NmQ5Y2MiLCJhdWQiOlsiaHR0cHM6Ly9hcHAuZW1lcmdldG1zLmNvbSIsImh0dHBzOi8vZW1lcmdlLXNzby10ZXN0LmF1dGgwLmNvbS91c2VyaW5mbyJdLCJpYXQiOjE1OTk3NzMzNTIsImV4cCI6MTU5OTg1OTc1MiwiYXpwIjoiSWpSRERQajFNeVV5SEg2TEF1aTFqY1loM3NuV0EweDYiLCJzY29wZSI6Im9wZW5pZCBwcm9maWxlIGVtYWlsIGFkZHJlc3MgcGhvbmUgYXRvbSByZnA6ZnAgcmZwOmNwIG9mZmxpbmVfYWNjZXNzIiwiZ3R5IjoicGFzc3dvcmQifQ.FamVUCPS7Q2B1u7zUPC5Guk2HKTQ6Km6i6CX_Tpg1h98gnuvnWrC9FF-awgldjHmCNoeqI9ImjEVpecP00oAtHWiDaXMTd7UsyPcHAWh2xatZ8LPCrnw-0ox3egSSv5KxCTrnXAhTxwR4XI07-jxWjTgkw5dSVGc70Q9a_PC8nXe7-1SDKmLpMKFmtU60eH52kmUy0CECi_GfYS7xKskZYgX3Xhx-C1jCWFbCbmRA1Yxvir450miOIo0g5AxaJjbTgm6ao2OGuPzyLUTrXaSchK1J9xrv8dXhKh-PSv0eIG5d2MVHJf4O_KsFckt40OuiiEokrdsfdsfdfhgsdOuDkQ expires_in: description: Expiration time of token in seconds. type: number example: 86400 refresh_token: description: The token required to call refresh_token endpoint to get a new access token. type: string example: ciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik9UYzROVFExTTBSRVF6SXhOamd6UVRZ error: type: object properties: code: type: integer example: 0 200_authenticationrefresh_response: type: object properties: response: type: object properties: token: description: The access token to be used in subsequent requests. type: string example: eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImtpZCI6Ik9UYzROVFExTTBSRVF6SXhOamd6UVRZNU0wSkNRak5HTWpVNE5VTkVNa1l4TVROQk9VSkROQSJ9.eyJodHRwczovL2F1dGgwLmVtZXJnZXRtcy5jb20vVXNlcklkIjoiY2ViN2Q0ZWYtOTA1YS00MTlkLWFjMWUtZmQ0Y2IwMzc4MjEyIiwiaHR0cHM6Ly9hdXRoMC5lbWVyZ2V0bXMuY29tL09yZ2FuaXphdGlvbklkIjoiZWU3YmRjMGItOTFiMy00NDAwLWFmZjUtYzc3ZGZlMjk3NjA2IiwiaHR0cHM6Ly9hdXRoMC5lbWVyZ2V0bXMuY29tL1NoaXBtZW50UHJvdmlkZXJPcmdhbml6YXRpb25JZCI6ImVlN2JkYzBiLTkxYjMtNDQwMC1hZmY1LWM3N2RmZTI5NzYwNiIsImlzcyI6Imh0dHBzOi8vZW1lcmdlLXNzby10ZXN0LmF1dGgwLmNvbS8iLCJzdWIiOiJhdXRoMHw1ZGQ2OGNjYjRmOGZmNzAzYjI5NmQ5Y2MiLCJhdWQiOlsiaHR0cHM6Ly9hcHAuZW1lcmdldG1zLmNvbSIsImh0dHBzOi8vZW1lcmdlLXNzby10ZXN0LmF1dGgwLmNvbS91c2VyaW5mbyJdLCJpYXQiOjE1OTk3NzMzNTIsImV4cCI6MTU5OTg1OTc1MiwiYXpwIjoiSWpSRERQajFNeVV5SEg2TEF1aTFqY1loM3NuV0EweDYiLCJzY29wZSI6Im9wZW5pZCBwcm9maWxlIGVtYWlsIGFkZHJlc3MgcGhvbmUgYXRvbSByZnA6ZnAgcmZwOmNwIG9mZmxpbmVfYWNjZXNzIiwiZ3R5IjoicGFzc3dvcmQifQ.FamVUCPS7Q2B1u7zUPC5Guk2HKTQ6Km6i6CX_Tpg1h98gnuvnWrC9FF-awgldjHmCNoeqI9ImjEVpecP00oAtHWiDaXMTd7UsyPcHAWh2xatZ8LPCrnw-0ox3egSSv5KxCTrnXAhTxwR4XI07-jxWjTgkw5dSVGc70Q9a_PC8nXe7-1SDKmLpMKFmtU60eH52kmUy0CECi_GfYS7xKskZYgX3Xhx-C1jCWFbCbmRA1Yxvir450miOIo0g5AxaJjbTgm6ao2OGuPzyLUTrXaSchK1J9xrv8dXhKh-PSv0eIG5d2MVHJf4O_KsFckt40OuiiEokrdsfdsfdfhgsdOuDkQ expires_in: description: Expiration time of token in seconds. type: number example: 86400 error: type: object properties: code: type: integer example: 0 200_getopportunity_response: description: 200 | OK. Opportunity successfully retrieved type: object properties: response: type: object properties: id: description: The opportunity ID type: integer example: 112020 organization_id: description: The ID of the organization type: integer example: 6338 length_of_haul: description: The calculated length of haul of the opportunity. Calculated in miles. type: integer example: 1084 length_of_haul_source_id: description: The source of the length of haul calculation. Enumeration. type: integer example: 2 is_length_of_haul_override_enabled: description: Boolean to indicate if the length of haul has been overridden. type: boolean example: false equipment_type_id: $ref: '#/components/schemas/equipment_type_id_object' reefer_maximum_temperature: description: The maximum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 20 reefer_minimum_temperature: description: The minimum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 1 cargo_value: description: The cargo value for this opportunity. type: number example: 100000 stops: $ref: '#/components/schemas/opportunity_response_stops_object' notes: $ref: '#/components/schemas/notes_object' commodities: $ref: '#/components/schemas/commodities_object' assigned_user_id: description: The user who is assigned to the opportunity. type: integer example: 1206858 references: $ref: '#/components/schemas/references_object' created_date: description: The date the opportunity was created. type: string example: '2021-09-15T00:48:15.2148104+00:00' modified_date: description: The date the opportunity was modified. type: string example: '2021-09-15T00:48:15.2148104+00:00' reference: type: string example: Q11112020 load_type_id: $ref: '#/components/schemas/load_type_id_object' freight_provider_organization_equipment_type_id: type: integer example: 8679 equipment_size: $ref: '#/components/schemas/equipment_size_object' status_id: $ref: '#/components/schemas/opportunity_status' is_tracking_required: type: boolean example: false is_hot_load: type: boolean example: false type_id: $ref: '#/components/schemas/opportunity_type' is_priced_at: type: boolean example: false is_deleted: type: boolean example: false accessorials: $ref: '#/components/schemas/accessorials_object' tags: $ref: '#/components/schemas/tags_object' ui_url: type: string description: The url for navigating to details page of an opportunity in emerge UI. example: https://app.emergemarket.io/en/quote/3243242 option_count: description: The number of options currently in the marketplace. type: integer example: 0 rate_type: description: The rate type of an opportunity. type: string enum: - ALL_IN: 1 - LH_ONLY: 2 example: 1 freight_provider_organization_equipment_type_name: type: string example: Reefer book_it_now: $ref: '#/components/schemas/response_book_it_now_object' bid_duration_end_time: description: The Date and Time the Bid Duration will End in UTC. Supports yyyy-mm-ddThh:mm:ss format. type: string example: '2021-10-06T10:30:20.3099236+00:00' quote_watchers: description: Identify additional users within your organization to provide quote notifications. type: array items: description: Email. type: string example: - shipper@stonelogistics.com - emergetest@emergetms.com error: type: object properties: code: description: HTTP code type: integer example: 0 200_getopportunities_response: description: 200 | OK. Opportunities successfully retrieved type: object properties: response: type: array items: type: object properties: id: description: The opportunity ID type: integer example: 112020 organization_id: description: The ID of the organization type: integer example: 6338 length_of_haul: description: The calculated length of haul of the opportunity. Calculated in miles. type: integer example: 1084 length_of_haul_source_id: description: The source of the length of haul calculation. Enumeration. type: integer example: 2 is_length_of_haul_override_enabled: description: Boolean to indicate if the length of haul has been overridden. type: boolean example: false equipment_type_id: $ref: '#/components/schemas/equipment_type_id_object' reefer_maximum_temperature: description: The maximum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 20 reefer_minimum_temperature: description: The minimum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 1 cargo_value: description: The cargo value for this opportunity. type: number example: 100000 stops: $ref: '#/components/schemas/opportunity_response_stops_object' notes: $ref: '#/components/schemas/notes_object' commodities: $ref: '#/components/schemas/commodities_object' assigned_user_id: description: The user who is assigned to the opportunity. type: integer example: 1206858 references: $ref: '#/components/schemas/references_object' created_date: description: The date the opportunity was created. type: string example: '2021-09-15T00:48:15.2148104+00:00' modified_date: description: The date the opportunity was modified. type: string example: '2021-09-15T00:48:15.2148104+00:00' reference: type: string example: Q11112020 load_type_id: $ref: '#/components/schemas/load_type_id_object' freight_provider_organization_equipment_type_id: type: integer example: 8679 equipment_size: $ref: '#/components/schemas/equipment_size_object' status_id: $ref: '#/components/schemas/opportunity_status' is_tracking_required: type: boolean example: false is_hot_load: type: boolean example: false type_id: $ref: '#/components/schemas/opportunity_type' is_priced_at: type: boolean example: false is_deleted: type: boolean example: false accessorials: $ref: '#/components/schemas/accessorials_object' tags: $ref: '#/components/schemas/tags_object' ui_url: type: string description: The url for navigating to details page of an opportunity in emerge UI. example: https://app.emergemarket.io/en/quote/3243242 option_count: description: The number of options currently in the marketplace. type: integer example: 0 rate_type: description: The rate type of an opportunity. type: string enum: - ALL_IN: 1 - LH_ONLY: 2 example: 1 error: type: object properties: code: description: HTTP code type: integer example: 0 200_options_response: type: object properties: response: type: object properties: count_of_active_options: description: A numerical count of the active options associated with the opportunity. type: integer example: 1 current_option: description: The lowest priced option. type: object properties: availability_date: type: string example: '2021-09-21T16:17:31.8333705+00:00' created_date: type: string example: '2021-09-21T16:17:31.8333705+00:00' modified_date: type: string example: '2021-09-21T16:17:49.5156372+00:00' opportunity_id: type: integer example: 16769 id: type: integer description: The ID of the option. example: 15633 rate: description: The rate offered to the shipper in USD type: number example: 3329.64 error: type: object properties: code: description: HTTP code type: integer example: 0 200_Alloptions_response: type: object properties: response: type: array items: type: object properties: opportunity_id: description: The id of the opportunity. type: integer example: 238842 option_id: description: The id of the option. type: integer example: 123 partner_quote_reference: description: The quote reference number of the option. type: string example: T12334 expiration_date: description: The expiration date of the option. type: string example: '2021-10-28T07:53:59.402Z' availability_date: description: The availability date of the option. type: string example: '2021-10-28T07:53:59.402' rate: description: Rate of the option. type: number example: 300 is_total_rate: description: true if linehaul and fuel rate included as part of total rate else false. type: boolean example: true modified_date: description: Modified date of the option. type: string example: '2020-10-28T07:53:59.402Z' created_date: description: Created date of the option. type: string example: '2020-10-28T07:53:59.402Z' partner: $ref: '#/components/schemas/200_getoption_partner_response' notes: description: option notes. type: string example: Test notes references: $ref: '#/components/schemas/references_object' error: type: object properties: code: description: HTTP code type: integer example: 0 200_getnetworkpartner_response: description: 200 | OK. Network partners successfully retrieved. type: object properties: response: type: array items: type: object properties: partner_id: description: The network partner identifier. type: integer example: 123 partner_code: description: Network partner's partner code. type: string example: AS1234 type: description: Network partner's type. type: string enum: - Network - Default status: description: Network partner's status. type: string enum: - AwaitingConfirmation - Confirmed created_date: description: Created date of the partner. type: string example: '2021-10-28T07:53:59.402Z' transportation_entity: type: object properties: company_name: description: Transportation entity company name. type: string example: My Carrier Logistic legal_name: description: Transportation entity legal name. type: string example: My Carrier Logistic dot_number: description: Transportation entity DOT number. type: integer example: 2894801 docket_number: description: Transportation entity Docket number. type: string example: MC143583 address: description: Transportation entity address. type: object properties: address: type: string example: 3665 North Harbor Drive city: type: string example: San Diego state: type: string example: CA postal_code: type: string example: '92101' contact: type: object properties: first_name: description: Network partner's first name. type: string example: mycarrier last_name: description: Network partner's last name. type: string example: test email: description: Network partner contact's email id. type: string format: email example: mycarrier.test@abc.com phone: description: Network partner contact's phone number. $ref: '#/components/schemas/phone_response_object' tags: $ref: '#/components/schemas/tags_object' error: $ref: '#/components/schemas/errorcode_zero' 200_invitenetworkpartner_response: description: 200 | OK. Network partners successfully retrieved. type: object properties: response: type: object properties: partner_id: description: The network partner identifier. type: integer example: 123 partner_code: description: Network partner's partner code. type: string example: AS1234 type: description: Network partner's type. type: string enum: - Network - Default status: description: Network partner's status. type: string enum: - AwaitingConfirmation - Confirmed created_date: description: Created date of the partner. type: string example: '2021-10-28T07:53:59.402Z' contact: description: Note that this may have different details from what was provided by the shipper when inviting the network partner. This happens when the network partner already existed in Emerge platform with different details or modifies it's details during or after registeration. type: object properties: first_name: description: Network partner's first name. type: string example: mycarrier last_name: description: Network partner's last name. type: string example: test email: description: Network partner contact's email id. type: string format: email example: mycarrier.test@abc.com phone: description: Network partner contact's phone number. $ref: '#/components/schemas/phone_response_object' transportation_entity: type: object properties: company_name: description: Transportation entity company name. type: string example: My Carrier Logistic legal_name: description: Transportation entity legal name. type: string example: My Carrier Logistic dot_number: description: Transportation entity DOT number. type: integer example: 2894801 docket_number: description: Transportation entity Docket number. type: string example: MC143583 address: description: Transportation entity address. type: object properties: address: type: string example: 3665 North Harbor Drive city: type: string example: San Diego state: type: string example: CA postal_code: type: string example: '92101' tags: $ref: '#/components/schemas/tags_object' error: $ref: '#/components/schemas/errorcode_zero' 201_createopportunity_response: description: 201 | Success. Opportunity successfully created type: object properties: response: type: object properties: id: description: The opportunity ID. The opportunity ID is used in subsequent calls. type: integer example: 19737 length_of_haul: description: The calculated length of haul of the opportunity. Calculated in miles. type: integer example: 1080 is_length_of_haul_override_enabled: description: Boolean to indicate if the length of haul has been overridden. type: boolean example: false is_schedule_required: description: Boolean that specifies if a schedule is required. type: boolean deprecated: true example: false equipment_type_id: $ref: '#/components/schemas/equipment_type_id_object' reefer_maximum_temperature: description: The maximum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 20 reefer_minimum_temperature: description: The minimum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 1 cargo_value: description: The cargo value for this opportunity. type: number example: 100000 assigned_user_id: description: The user who is assigned to the opportunity. type: integer example: 1206858 invite_by_tag: description: Defines the network partner tags to whom the opportunity is posted. It will contain only the valid tags. type: array items: type: string example: firstTag stops: $ref: '#/components/schemas/opportunity_response_stops_object' notes: $ref: '#/components/schemas/notes_object' commodities: $ref: '#/components/schemas/commodities_object' references: $ref: '#/components/schemas/references_object' created_date: description: The date timestamp of the creation of the opportunity. type: string example: '2019-02-09T18:07:05.460965+00:00' reference: description: The quote number associated with the opportunity. type: string example: Q43434222 accessorials: $ref: '#/components/schemas/accessorials_object' tags: $ref: '#/components/schemas/tags_object' ui_url: type: string description: The url for navigating to details page of an opportunity in emerge UI. example: https://app.emergemarket.io/en/quote/3243242 rate_type: description: The rate type of an opportunity. type: string enum: - ALL_IN: 1 - LH_ONLY: 2 example: 1 freight_provider_organization_equipment_type_id: type: integer example: 974 freight_provider_organization_equipment_type_name: type: string example: Reefer bid_duration_end_time: description: The Date and Time the Bid Duration will End in UTC. Supports yyyy-mm-ddThh:mm:ss format. type: string example: '2021-10-06T10:30:20.3099236+00:00' quote_watchers: description: Identify additional users within your organization to provide quote notifications. type: array items: description: Email. type: string example: - shipper@stonelogistics.com - emergetest@emergetms.com shipment_id: description: The shipment ID associated with the opportunity. The shipment ID is used in subsequent calls. type: integer example: 54321 error: type: object properties: code: description: HTTP code type: integer example: 0 200_updateopportunity_response: description: 200 | OK. Opportunity successfully retrieved type: object properties: response: type: object properties: id: description: The opportunity ID type: integer example: 112020 organization_id: description: The ID of the organization type: integer example: 6338 length_of_haul: description: The calculated length of haul of the opportunity. Calculated in miles. type: integer example: 1084 length_of_haul_source_id: description: The source of the length of haul calculation. Enumeration. type: integer example: 2 is_length_of_haul_override_enabled: description: Boolean to indicate if the length of haul has been overridden. type: boolean example: false equipment_type_id: $ref: '#/components/schemas/equipment_type_id_object' reefer_maximum_temperature: description: The maximum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 20 reefer_minimum_temperature: description: The minimum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 1 cargo_value: description: The cargo value for this opportunity. type: number example: 100000 stops: $ref: '#/components/schemas/opportunity_response_stops_object' notes: $ref: '#/components/schemas/notes_object' commodities: $ref: '#/components/schemas/commodities_object' assigned_user_id: description: The user who is assigned to the opportunity. type: integer example: 1206858 references: $ref: '#/components/schemas/references_object' created_date: description: The date the opportunity was created. type: string example: '2021-09-15T00:48:15.2148104+00:00' modified_date: description: The date the opportunity was modified. type: string example: '2021-09-15T00:48:15.2148104+00:00' reference: type: string example: Q11112020 load_type_id: $ref: '#/components/schemas/load_type_id_object' freight_provider_organization_equipment_type_id: type: integer example: 8679 equipment_size: $ref: '#/components/schemas/equipment_size_object' status_id: $ref: '#/components/schemas/opportunity_status' is_tracking_required: type: boolean example: false is_hot_load: type: boolean example: false type_id: $ref: '#/components/schemas/opportunity_type' is_priced_at: type: boolean example: false is_deleted: type: boolean example: false accessorials: $ref: '#/components/schemas/accessorials_object' tags: $ref: '#/components/schemas/tags_object' ui_url: type: string description: The url for navigating to details page of an opportunity in emerge UI. example: https://app.emergemarket.io/en/quote/3243242 option_count: description: The number of options currently in the marketplace. type: integer example: 0 rate_type: description: The rate type of an opportunity. type: string enum: - ALL_IN: 1 - LH_ONLY: 2 example: 1 freight_provider_organization_equipment_type_name: type: string example: Reefer bid_duration_end_time: description: The Date and Time the Bid Duration will End in UTC. Supports yyyy-mm-ddThh:mm:ss format. type: string example: '2021-10-06T10:30:20.3099236+00:00' error: type: object properties: code: description: HTTP code type: integer example: 0 201_createtender_response: description: 201 | Success. Tender successfully created type: object properties: response: type: object properties: id: description: The tender ID. The tender ID is used in subsequent calls. type: integer example: 232343 assigned_user_id: type: integer example: 1305583 partner_id: type: integer example: 953 shipment_id: type: integer example: 16679 shipment_status_id: $ref: '#/components/schemas/shipment_status' load_type_id: $ref: '#/components/schemas/load_type_id_object' equipment_type_id: $ref: '#/components/schemas/equipment_type_id_object' reefer_maximum_temperature: description: The maximum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 20 reefer_minimum_temperature: description: The minimum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 1 freight_provider_organization_equipment_type_id: type: integer example: 974 freight_provider_organization_equipment_type_name: type: string example: Reefer length_of_haul: type: integer example: 1084 length_of_haul_source_id: description: The source of the length of haul calculation. Enumeration. type: integer example: 2 is_length_of_haul_override_enabled: description: Boolean to indicate if the length of haul has been overridden. type: boolean example: false length_of_haul_result: $ref: '#/components/schemas/length_of_haul_result_object' is_tracking_required: type: boolean example: false rate: description: The rate for the shipment in USD. type: integer example: 3866 rate_per_mile: description: the rate for the shipment per mile in USD. type: number example: 3.57 fuel_rate: description: The total rate for the fuel in USD. type: number example: 238.48 is_hot_load: type: boolean example: false option_id: description: The ID of the option associated with the tender type: integer example: 15618 option: description: The option details type: object properties: id: description: The ID of the option associated with the tender type: integer example: 15618 modified_date: type: string example: '2021-09-18T20:39:20.8137938+00:00' type_id: type: integer example: 5 opportunity_id: type: integer example: 16734 partner_id: type: integer example: 953 rate: type: integer example: 3866 rate_per_mile: type: number example: 3.57 fuel_rate: type: number example: 238.48 is_fuel_included: type: boolean example: false line_haul_rate: type: number example: 3627.52 line_haul_rate_per_mile: type: number example: 3.35 notes: $ref: '#/components/schemas/notes_object' commodities: $ref: '#/components/schemas/commodities_object' stops: $ref: '#/components/schemas/opportunity_response_stops_object' references: $ref: '#/components/schemas/references_object' accessorials: $ref: '#/components/schemas/accessorials_object' notes: $ref: '#/components/schemas/notes_object' error: $ref: '#/components/schemas/errorcode_zero' 200_getshipment_response: description: 200 | Ok. Returns shipment details. type: object properties: response: type: object properties: id: type: integer example: 1305583 opportunity: type: object properties: id: description: The opportunity ID type: integer example: 112020 organization_id: description: The ID of the organization type: integer example: 6338 length_of_haul: description: The calculated length of haul of the opportunity. Calculated in miles. type: integer example: 1084 length_of_haul_source_id: description: The source of the length of haul calculation. type: integer example: 2 is_length_of_haul_override_enabled: description: Boolean to indicate if the length of haul has been overridden. type: boolean example: false stops: $ref: '#/components/schemas/opportunity_response_stops_object' notes: $ref: '#/components/schemas/notes_object' commodities: $ref: '#/components/schemas/commodities_object' assigned_user_id: description: The user who is assigned to the opportunity. type: integer example: 1206858 references: $ref: '#/components/schemas/references_object' created_date: description: The date the opportunity was created. type: string example: '2020-09-15T00:48:15.2148104+00:00' modified_date: description: The date the opportunity was modified. type: string example: '2020-09-15T00:48:15.2148104+00:00' reference: type: string example: Q11112020 load_type_id: $ref: '#/components/schemas/load_type_id_object' equipment_type_id: $ref: '#/components/schemas/equipment_type_id_object' freight_provider_organization_equipment_type_id: type: integer example: 8679 equipment_size: $ref: '#/components/schemas/equipment_size_object' status_id: $ref: '#/components/schemas/opportunity_status' is_tracking_required: type: boolean example: false is_hot_load: type: boolean example: false type_id: $ref: '#/components/schemas/opportunity_type' is_priced_at: type: boolean example: false is_deleted: type: boolean example: false accessorials: $ref: '#/components/schemas/accessorials_object' tags: $ref: '#/components/schemas/tags_object' option_count: description: The number of options currently in the marketplace. type: integer example: 0 reference: type: string example: S11019753 status_id: $ref: '#/components/schemas/shipment_status' current_tender: type: object properties: id: description: The tender ID. The tender ID is used in subsequent calls. type: integer example: 232343 assigned_user_id: type: integer example: 1305583 partner_id: type: integer example: 953 shipment_id: type: integer example: 16679 shipment_status_id: $ref: '#/components/schemas/shipment_status' load_type_id: $ref: '#/components/schemas/load_type_id_object' equipment_type_id: $ref: '#/components/schemas/equipment_type_id_object' freight_provider_organization_equipment_type_id: type: integer example: 974 freight_provider_organization_equipment_type_name: type: string example: Reefer length_of_haul: type: integer example: 1084 length_of_haul_source_id: description: The source of the length of haul calculation. Enumeration. type: integer example: 2 is_length_of_haul_override_enabled: description: Boolean to indicate if the length of haul has been overridden. type: boolean example: false length_of_haul_result: $ref: '#/components/schemas/length_of_haul_result_object' is_tracking_required: type: boolean example: false rate: description: The rate for the shipment in USD. type: integer example: 3866 rate_per_mile: description: the rate for the shipment per mile in USD. type: number example: 3.57 fuel_rate: description: The total rate for the fuel in USD. type: number example: 238.48 is_hot_load: type: boolean example: false reefer_maximum_temperature: description: The maximum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 20 reefer_minimum_temperature: description: The minimum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 1 option_id: description: The ID of the option associated with the tender type: integer example: 15618 option: description: The option details type: object properties: id: description: The ID of the option associated with the tender type: integer example: 15618 modified_date: type: string example: '2020-09-18T20:39:20.8137938+00:00' type_id: type: integer example: 5 opportunity_id: type: integer example: 16734 partner_id: type: integer example: 953 rate: type: integer example: 3866 rate_per_mile: type: number example: 3.57 fuel_rate: type: number example: 238.48 is_fuel_included: type: boolean example: false line_haul_rate: type: number example: 3627.52 line_haul_rate_per_mile: type: number example: 3.35 notes: $ref: '#/components/schemas/notes_object' commodities: $ref: '#/components/schemas/commodities_object' stops: $ref: '#/components/schemas/opportunity_response_stops_object' references: $ref: '#/components/schemas/references_object' accessorials: $ref: '#/components/schemas/accessorials_object' notes: $ref: '#/components/schemas/notes_object' public_tracking_link: description: This feature is limited to ProcureOS Pro plans type: string example: https://app.emergemarket.io/en/publictracking/12345 400_badrequest_response: type: object properties: error: type: object properties: code: description: HTTP code type: integer example: 400 detailed_errors: description: Error messages type: array items: type: object properties: key: type: string example: load_type_id value: type: string example: load_type_id has a range of values which does not include 12 messages: type: array items: type: string example: Validation failed. 400_badrequest_webhook_response: type: object properties: error: type: object properties: code: description: HTTP code type: integer example: 400 detailed_errors: description: Error messages type: array items: type: object properties: key: type: string example: url value: type: string example: url must not be empty. messages: type: array items: type: string example: Validation failed. 400_badrequest_networkpartner_response: type: object properties: error: type: object properties: code: description: HTTP code type: integer example: 400 detailed_errors: description: Error messages type: array items: type: object properties: key: type: string example: first_name value: type: string example: first_name must not be empty. messages: type: array items: type: string example: Validation failed. 400_badrequest_opportunitybyid_response: type: object properties: error: type: object properties: code: description: HTTP code type: integer example: 400 messages: type: array items: type: string example: Quote not found. 400_badrequest_opportunity_notification_response: type: object properties: error: type: object properties: code: description: HTTP code type: integer example: 400 messages: type: array items: type: string example: Validation failed. detailed_errors: description: Error messages type: array items: type: object properties: key: type: string example: partner_ids value: type: string example: '''partner_ids'' or ''partner_codes'' must not be empty when post_to_all is false.' 400_badrequest_opportunitypost_response: type: object properties: error: type: object properties: code: description: HTTP code type: integer example: 400 detailed_errors: description: Error messages type: array items: type: object properties: key: type: string example: posting_to value: type: string example: posting_to must not be empty. messages: type: array items: type: string example: Validation failed. 400_badrequest_createaward_response: type: object properties: error: type: object properties: code: description: HTTP code type: integer example: 400 detailed_errors: description: Error messages type: array items: type: object properties: key: type: string example: option_id value: type: string example: option_id must not be empty. messages: type: array items: type: string example: Validation failed. 400_badrequest_createtender_response: type: object properties: error: type: object properties: code: description: HTTP code type: integer example: 400 detailed_errors: description: Error messages type: array items: type: object properties: key: type: string example: opportunity_id value: type: string example: opportunity_id must not be empty. messages: type: array items: type: string example: Validation failed. 400_badrequest_updatetender_response: type: object properties: error: type: object properties: code: description: HTTP code type: integer example: 400 detailed_errors: description: Error messages type: array items: type: object properties: key: type: string example: shipment_id value: type: string example: shipment_id must not be empty. messages: type: array items: type: string example: Validation failed. 400_badrequest_refreshtoken_response: type: object properties: error: type: object properties: code: description: HTTP code type: integer example: 400 detailed_errors: description: Error messages type: array items: type: object properties: key: type: string example: refresh_token value: type: string example: refresh_token must not be empty. messages: type: array items: type: string example: Validation failed. 403_forbidden_response: type: object properties: error: type: object properties: code: description: HTTP code type: integer example: 403 messages: description: Error messages type: array items: type: string example: Response status code does not indicate success 403 (Forbidden) 409_response: type: object properties: error: type: object properties: code: type: integer example: 409 messages: type: array items: type: string example: The tender status is invalid. 429_response: type: object properties: error: type: object properties: code: type: integer example: 429 messages: type: array items: type: string example: Too many requests. 500_response: type: object properties: error: type: object properties: code: type: integer example: 500 messages: type: array items: type: string example: userName. create_opportunity_request_object: type: object required: - stops - commodities - load_type_id - equipment_type_id properties: load_type_id: $ref: '#/components/schemas/request_load_type_id_object' equipment_type_id: $ref: '#/components/schemas/request_equipment_type_id_object' reefer_maximum_temperature: description: The maximum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 20 reefer_minimum_temperature: description: The minimum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 1 equipment_size: $ref: '#/components/schemas/equipment_size_object' search_in_marketplace: description: Defines if the opportunity is upon creation submitted to the Emerge marketplace. type: boolean default: true request_all_network_partners: description: Defines if the opportunity is upon creation submitted to the network partners. type: boolean default: false is_hot_load: description: Identifies if the load is hot. type: boolean default: false is_tracking_required: description: Defines if tracking is required on this opportunity. type: boolean default: false cargo_value: description: The cargo value for this opportunity. type: number minimum: 1 example: 100000 assigned_user: description: Defines the user to whom the opportunity will be assigned. If not provided, it will be defaulted to the authenticated user. type: string format: email example: shipper@stonelogistics.com invite_by_tag: $ref: '#/components/schemas/invite_by_tag_object' stops: $ref: '#/components/schemas/opportunity_request_stops_object' commodities: $ref: '#/components/schemas/request_commodities_object' accessorials: $ref: '#/components/schemas/request_accessorials_object' references: $ref: '#/components/schemas/request_references_object' notes: description: Opportunity notes. type: array items: properties: note: description: The specific note for the opportunity type: string tags: $ref: '#/components/schemas/tags_object' mileage_override: description: Miles to be overridden. type: integer example: 12 custom_equipment_type: description: Custom equipment type. type: string example: custom type book_it_now: description: Book it now related data. type: object $ref: '#/components/schemas/request_book_it_now_object' bid_duration_end_time: description: The Date and Time the Bid Duration will End in UTC. Supports yyyy-mm-ddThh:mm:ss format. type: string example: '2021-10-06T10:30:20' quote_watchers: description: Identify additional users within your organization to provide quote notifications. type: array items: description: Email. type: string example: - shipper@stonelogistics.com - emergetest@emergetms.com update_opportunity_request_object: type: object required: - stops - commodities - load_type_id - equipment_type_id properties: load_type_id: $ref: '#/components/schemas/request_load_type_id_object' equipment_type_id: $ref: '#/components/schemas/request_equipment_type_id_object' reefer_maximum_temperature: description: The maximum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 20 reefer_minimum_temperature: description: The minimum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 1 equipment_size: $ref: '#/components/schemas/equipment_size_object' request_all_network_partners: description: Defines if the opportunity is upon creation submitted to the network partners. type: boolean default: false is_hot_load: description: Identifies if the load is hot. type: boolean default: false is_tracking_required: description: Defines if tracking is required on this opportunity. type: boolean default: false cargo_value: description: The cargo value for this opportunity. type: number minimum: 1 example: 100000 assigned_user: description: Defines the user to whom the opportunity will be assigned. If not provided, it will be defaulted to the authenticated user. type: string format: email example: shipper@stonelogistics.com stops: $ref: '#/components/schemas/opportunity_request_stops_object' commodities: $ref: '#/components/schemas/request_commodities_object' accessorials: $ref: '#/components/schemas/request_accessorials_object' references: $ref: '#/components/schemas/request_references_object' notes: description: Opportunity notes. type: array items: properties: note: description: The specific note for the opportunity type: string tags: $ref: '#/components/schemas/tags_object' mileage_override: description: Miles to be overridden. type: integer example: 12 custom_equipment_type: description: Custom equipment type. type: string example: custom type bid_duration_end_time: description: The Date and Time the Bid Duration will End in UTC. Supports yyyy-mm-ddThh:mm:ss format. type: string example: '2021-10-06T10:30:20' tenders: type: object required: - stops - commodities properties: load_type_id: $ref: '#/components/schemas/request_load_type_id_object' equipment_type_id: $ref: '#/components/schemas/request_equipment_type_id_object' reefer_maximum_temperature: description: The maximum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 20 reefer_minimum_temperature: description: The minimum temperature for reefer in degree Fahrenheit. Only valid for Reefer equipment type. type: integer example: 1 equipment_size: $ref: '#/components/schemas/equipment_size_object' is_hot_load: description: Identifies if the load is hot. type: boolean default: false is_tracking_required: description: Defines if tracking is required on this opportunity. type: boolean default: false stops: $ref: '#/components/schemas/stops_object' commodities: $ref: '#/components/schemas/request_commodities_object' accessorials: $ref: '#/components/schemas/request_accessorials_object' references: $ref: '#/components/schemas/request_references_object' notes: $ref: '#/components/schemas/notes_object' tags: $ref: '#/components/schemas/tags_object' option_id: description: The Id of the option that is to be tendered against. type: integer example: 323324 minimum: 1 opportunity_id: description: The opportunity identifier. type: integer example: 213698 minimum: 1 mileage_override: description: Miles to be overridden. type: integer example: 12 custom_equipment_type: description: Custom equipment type. type: string example: custom type request_accessorials_object: description: The accessorials associated with the load. type: array items: type: object properties: accessorial_type_id: description: The type of accessorial required.
Enum:
"Straps" "ETracks" "LoadLocks" "BlockAndBrace" "Blankets" "DriverLoadAssist" "DriverTailgateAssist" "EdgeProtector" "BulkHeads" "SmokedTarps" "StandardTarps" "VBoards" "CoilRacks" "PipeStakes" "Headboard" "Dunnage" "Ramps" "LoadLevelers" "Chains" "Other" "TeamDrivers" "PreCool" "WoodenFloor" "PersonalProtectiveEquipment" "FtlInsideDelivery" "Liftgate" "FoodGrade" "TWICRequired" "TankerEndorsement" "ProtectFromFreeze" "LightScaleTicketRequired" "PalletJack"
type: string example: Blankets value: description: The accessorial quantity. type: string example: '1' accessorials_object: description: The accessorials associated with the load. type: array items: type: object properties: accessorial_type_id: description: The type of accessorial required.
Enum:
{"Straps":127} {"ETracks":128} {"LoadLocks":129} {"BlockAndBrace":130} {"Blankets":131} {"DriverLoadAssist":132} {"DriverTailgateAssist":133} {"EdgeProtector":134} {"BulkHeads":135} {"SmokedTarps":136} {"StandardTarps":137} {"VBoards":138} {"CoilRacks":139} {"PipeStakes":140} {"Headboard":141} {"Dunnage":142} {"Ramps":143} {"LoadLevelers":144} {"Chains":145} {"Other":146} {"TeamDrivers":147} {"PreCool":148} {"WoodenFloor":153} {"PersonalProtectiveEquipment":154} {"FtlInsideDelivery":155} {"Liftgate":156} {"FoodGrade":157} {"TWICRequired":158} {"TankerEndorsement":159} {"ProtectFromFreeze":160} {"LightScaleTicketRequired":161} {"PalletJack":162}
type: string example: 131 value: description: The accessorial quantity. type: string example: '1' request_book_it_now_object: description: Book it now related data. type: object properties: enabled: description: Defines if Book it Now will populate n a quote upon creation. This overrides the “Set Dynamic BIN using the default starting and ceiling rates for API and Bulk Upload quotes” organization setting. type: boolean default: false example: false start: description: Starting price for dynamic book it now. When not provided, the starting rate will calculate based on the rate pulse or ceiling rate. type: integer ceiling: description: Ceiling price for the dynamic book it now. type: integer response_book_it_now_object: description: Book it now related data. type: object properties: enabled: description: Defines if Book it Now will populate n a quote upon creation. This overrides the “Set Dynamic BIN using the default starting and ceiling rates for API and Bulk Upload quotes” organization setting. type: boolean default: false example: false price: description: Book it now price. type: integer start: description: Starting dynamic book book it now price. Must be paired with the ceiling rate to set Dynamic Book it Now. type: integer ceiling: description: Ceiling dynamic book book it now price. Must be paired with the start rate to set Dynamic Book it Now. type: integer request_commodities_object: description: A description of the items to be carried by the capacity provider. type: array items: type: object required: - name - weight properties: id: description: The commodity identifier. type: integer default: 0 name: description: The name and description of the commodity. type: string example: FAK weight: description: The weight of the commodity in lbs. type: integer example: 100 quantity_unit_id: description: The type of unit the commodity is moved on. type: string enum: - Other - Pallet - Box - Crate - Bag - Coils - Drums - Reels - Rolls - TubesOrPipes - Slipsheets - Bale - Bucket - Bundle - Can - Carton - Case - Cylinder - Pail - Pieces - Skid example: Other unit_count: description: The unit count of the commodity. type: integer example: 2 piece_count: description: The piece count of the commodity. type: integer example: 24 length: description: The length of the commodity. type: integer example: 48 width: description: The width of the commodity. type: integer example: 40 height: description: The height of the commodity. type: integer example: 60 is_stackable: description: Flag identifying a stackable commodity. Default value is false. type: boolean default: false example: false is_hazmat: description: Flag identifying a hazmat commodity. Default value is false. type: boolean default: false example: true hazmat: type: object properties: identification_number: description: The hazmat identification number for the dangerous substances. type: string example: UN1000 packing_group_id: description: The packing group identifier for the hazmat load. enum: - High - Moderate - Low - None type: string example: High class_id: description: The class of the hazmat load enum: - MassExplosiveHazard - ProjectionHazard - MassFireHazard - MinorExplosionHazard - VeryInsensitiveExplosives - ExtremelyInsensitiveExplosives - FlammableGases - NonFlammableGases - PoisonousOrToxic - CombustibleLiquids - FlammableSolid - SpontaneouslyCombustibleMaterial - DangerousWhenWet - Oxidizer - OrganicPeroxide - PoisonousOrToxicMaterial - InfectiousSubstance - RadioactiveMaterial - Corrosives - MiscellaneousDangerousGoods type: string example: ExtremelyInsensitiveExplosives emergency_contact: description: The person to be contacted regarding an emergency with this Hazmat load. type: object properties: name: description: The name of the contact responsible for the hazmat load. type: string example: Kyle Jepsen phone: description: The phone number of the emergency contact. $ref: '#/components/schemas/phone_response_object' commodities_object: description: A description of the items to be carried by the capacity provider. type: array items: type: object required: - name - weight properties: id: description: The commodity identifier. type: integer default: 0 name: description: The name and description of the commodity. type: string example: FAK weight: description: The weight of the commodity in lbs. type: integer example: 100 quantity_unit_id: description: The type of unit the commodity is moved on. type: string enum: - Other: 0 - Pallet: 1 - Box: 2 - Crate: 3 - Bag: 4 - Coils: 5 - Drums: 6 - Reels: 7 - Rolls: 8 - TubesOrPipes: 9 - Slipsheets: 10 - Bale: 11 - Bucket: 12 - Bundle: 13 - Can: 14 - Carton: 15 - Case: 16 - Cylinder: 17 - Pail: 18 - Pieces: 19 - Skid: 20 example: 0 unit_count: description: The unit count of the commodity. type: integer example: 2 piece_count: description: The piece count of the commodity. type: integer example: 24 length: description: The length of the commodity. type: integer example: 48 width: description: The width of the commodity. type: integer example: 40 height: description: The height of the commodity. type: integer example: 60 is_stackable: description: Flag identifying a stackable commodity. Default value is false. type: boolean default: false example: false is_hazmat: description: Flag identifying a hazmat commodity. Default value is false. type: boolean default: false example: true hazmat: type: object properties: identification_number: description: The hazmat identification number for the dangerous substances. type: string example: UN1000 packing_group_id: description: The packing group identifier for the hazmat load. enum: - High: 1 - Moderate: 2 - Low: 3 - None: 4 type: string example: 1 class_id: description: The class of the hazmat load enum: - MassExplosiveHazard: 1 - ProjectionHazard: 2 - MassFireHazard: 3 - MinorExplosionHazard: 4 - VeryInsensitiveExplosives: 5 - ExtremelyInsensitiveExplosives: 6 - FlammableGases: 7 - NonFlammableGases: 8 - PoisonousOrToxic: 9 - CombustibleLiquids: 10 - FlammableSolid: 11 - SpontaneouslyCombustibleMaterial: 12 - DangerousWhenWet: 13 - Oxidizer: 14 - OrganicPeroxide: 15 - PoisonousOrToxicMaterial: 16 - InfectiousSubstance: 17 - RadioactiveMaterial: 18 - Corrosives: 19 - MiscellaneousDangerousGoods: 20 type: string example: 6 emergency_contact: description: The person to be contacted regarding an emergency with this Hazmat load. type: object properties: name: description: The name of the contact responsible for the hazmat load. type: string example: Kyle Jepsen phone: description: The phone number of the emergency contact. $ref: '#/components/schemas/phone_response_object' equipment_size_object: description: The length of the trailer. type: integer minimum: 1 example: 2 length_of_haul_result_object: description: The length of haul override. type: object properties: manual: type: integer example: 2 errorcode_zero_object: type: object properties: error: type: object properties: code: description: HTTP code type: integer example: 0 messages: description: Error messages type: array items: type: string example: No message errorcode_zero_without_message_object: type: object properties: error: type: object properties: code: description: HTTP code type: integer example: 0 errorcode_zero: type: object properties: code: description: HTTP code type: integer example: 0 notes_object: type: array items: description: This shipment is ready to go now. Please provide your best options. properties: note: description: The specific note for the opportunity type: string request_references_object: required: - Customer description: References for the opportunity. type: array items: type: object properties: type_id: description: The type of reference. type: string enum: - Other - Customer - Appointment - Bol - Delivery - Pickup - PickupConfirmation - Po - Pro - Trailer example: Customer value: description: The reference value. type: string example: CustRef123 references_object: required: - Customer description: References for the opportunity. type: array items: type: object properties: type_id: description: The type of reference. type: string enum: - Other: 1 - Customer: 2 - Appointment: 3 - Bol: 4 - Delivery: 5 - Pickup: 6 - PickupConfirmation: 7 - Po: 8 - Pro: 9 - Trailer: 10 example: 2 value: description: The reference value. type: string example: CustRef123 opportunity_response_stops_object: description: The stops associated with the opportunity. An opportunity must have at least two stops. type: array items: type: object required: - order - action_type_id - postal_code - city - state - country - appointment_type_id properties: type_id: description: The type of the stop. type: string enum: - Origin: 1 - Middle: 2 - Destination: 3 example: 1 appointment_type_id: description: The appointment type. type: string deprecated: true enum: - FCFS: 1 - Appointment: 2 example: 1 standardized_appointment_type_id: description: The appointment type of the stop. type: string enum: - FCFS: 1 - AppointmentScheduled: 2 - AppointmentRequired: 3 example: 1 standardized_loading_type_id: description: The loading or unloading type of the stop. type: string enum: - Live: 1 - DropTrailer: 2 example: 1 address1: type: string example: 3665 North Harbor Drive address2: type: string example: string city: type: string example: San Diego contact: type: object properties: name: description: The contact name for the person at the stop. type: string example: Shipper phone: description: The phone number for the contact at the stop. $ref: '#/components/schemas/phone_response_object' email: type: string format: email example: shipper@stonelogistics.com country: description: The country of the stop. Use abbreviation US or USA for United States of America and CA or CAN for Canada. type: string example: US state: description: The state of the stop. Use abbreviation. type: string example: CA postal_code: type: string example: '92101' latitude: description: The latitude of the stop (use decimal representation) type: number example: 32.7325 longitude: description: The longitude of the stop (use decimal representation) type: number example: -117.2011 name: description: The name for the stop. type: string example: Stone Brewing Company note: description: Notes associated with the stop. type: string example: Check in with security prior to loading or unloading. order: description: The order of the stop-starting with 1. type: integer example: 1 action_type_id: description: The stop action. type: string enum: - Pick: 1 - Drop: 2 example: 1 schedule: description: The schedule associated with the stop. type: object deprecated: true properties: date: description: The date associated with the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-06' start_time: description: Based upon the local time at the stop, the earliest time the load is available. Supports the format hh:mm:ss type: string example: '14:00:00' end_time: description: Based upon the local time at the stop, the last time the load is available. Supports the format hh:mm:ss type: string example: '20:00:00' standardized_schedule: description: The schedule associated with the stop. type: object properties: start_date: description: The earliest date associated with the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-06' start_time: description: Based upon the local time at the stop, the earliest time the load is available. Supports the format hh:mm:ss type: string example: '14:00:00' end_date: description: The latest date associated with the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-07' end_time: description: Based upon the local time at the stop, the last time the load is available. Supports the format hh:mm:ss type: string example: '20:00:00' raw_address: description: A string version of the full address type: string example: 23, Phoenix is_schedule_required: description: Determines if a shipper will allow the carrier to schedule an appointment on their behalf. Not recommended for the marketplace workflow type: boolean deprecated: true example: false invite_by_tag_object: description: Defines the network partner tags to whom the opportunity has to be posted. This will be ignored if `request_all_network_partners` is passed as `true`. type: array items: type: string example: firstTag opportunity_request_stops_object: description: The stops associated with the opportunity. An opportunity must have at least two stops. type: array items: type: object required: - order - action_type_id - postal_code - city - state - country - appointment_type_id - standardized_appointment_type_id - standardized_loading_type_id properties: type_id: description: The type of the stop. type: string enum: - Origin - Middle - Destination example: Origin appointment_type_id: description: The appointment type. type: string deprecated: true enum: - FCFS - Appointment example: Appointment standardized_appointment_type_id: description: The appointment type of the stop. type: string enum: - FCFS - AppointmentScheduled - AppointmentRequired example: FCFS standardized_loading_type_id: description: The loading or unloading type of the stop. type: string enum: - Live - DropTrailer example: Live address1: type: string example: 3665 North Harbor Drive address2: type: string example: string city: type: string example: San Diego contact: type: object properties: name: description: The contact name for the person at the stop. type: string example: Shipper phone: description: The phone number for the contact at the stop. $ref: '#/components/schemas/phone_response_object' email: type: string format: email example: shipper@stonelogistics.com country: description: The country of the stop. Use abbreviation US or USA for United States of America and CA or CAN for Canada. type: string example: US state: description: The state of the stop. Use abbreviation. type: string example: CA postal_code: type: string example: '92101' latitude: description: The latitude of the stop (use decimal representation) type: number example: 32.7325 longitude: description: The longitude of the stop (use decimal representation) type: number example: -117.2011 name: description: The name for the stop. type: string example: Stone Brewing Company note: description: Notes associated with the stop. type: string example: Check in with security prior to loading or unloading. order: description: The order of the stop-starting with 1. type: integer example: 1 action_type_id: description: The stop action. type: string enum: - Pick - Drop example: Pick schedule: description: The schedule associated with the stop. type: object deprecated: true properties: date: description: The date associated with the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-06' start_time: description: Based upon the local time at the stop, the earliest time the load is available. Supports the format hh:mm:ss type: string example: '14:00:00' end_time: description: Based upon the local time at the stop, the last time the load is available. Supports the format hh:mm:ss type: string example: '20:00:00' standardized_schedule: description: The schedule associated with the stop. type: object properties: start_date: description: The earliest date associated with the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-06' start_time: description: Based upon the local time at the stop, the earliest time the load is available. Supports the format hh:mm:ss type: string example: '14:00:00' end_date: description: The latest date associated with the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-07' end_time: description: Based upon the local time at the stop, the last time the load is available. Supports the format hh:mm:ss type: string example: '20:00:00' raw_address: description: A string version of the full address type: string example: 23, Phoenix is_schedule_required: description: Determines if a shipper will allow the carrier to schedule an appointment on their behalf. Not recommended for the marketplace workflow type: boolean deprecated: true example: false stops_object: description: The stops associated with the opportunity. An opportunity must have at least two stops. type: array items: type: object required: - order - name - address1 - address2 - city - state - country properties: type_id: description: The type of the stop. type: string enum: - Origin - Middle - Destination example: Origin appointment_type_id: description: The appointment type. type: string deprecated: true enum: - FCFS - Appointment example: Appointment standardized_appointment_type_id: description: The appointment type of the stop. type: string enum: - FCFS - AppointmentScheduled - AppointmentRequired example: FCFS standardized_loading_type_id: description: The loading or unloading type of the stop. type: string enum: - Live - DropTrailer example: Live address1: type: string example: 3665 North Harbor Drive address2: type: string example: string city: type: string example: San Diego contact: type: object properties: name: description: The contact name for the person at the stop. type: string example: Shipper phone: description: The phone number for the contact at the stop. $ref: '#/components/schemas/phone_response_object' email: type: string format: email example: shipper@stonelogistics.com country: description: The country of the stop. Use abbreviation US or USA for United States of America and CA or CAN for Canada. type: string example: US state: description: The state of the stop. Use abbreviation. type: string example: CA postal_code: type: string example: '92101' latitude: description: The latitude of the stop (use decimal representation) type: number example: 32.7325 longitude: description: The longitude of the stop (use decimal representation) type: number example: -117.2011 name: description: The name for the stop. type: string example: Stone Brewing Company note: description: Notes associated with the stop. type: string example: Check in with security prior to loading or unloading. order: description: The order of the stop-starting with 1. type: integer example: 1 action_type_id: description: The stop action. type: string enum: - Pick - Drop example: Pick schedule: description: The schedule associated with the stop. type: object deprecated: true properties: date: description: The date associated with the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-06' start_time: description: Based upon the local time at the stop, the earliest time the load is available. Supports the format hh:mm:ss type: string example: '14:00:00' end_time: description: Based upon the local time at the stop, the last time the load is available. Supports the format hh:mm:ss type: string example: '20:00:00' standardized_schedule: description: The schedule associated with the stop. type: object properties: start_date: description: The earliest date associated with the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-06' start_time: description: Based upon the local time at the stop, the earliest time the load is available. Supports the format hh:mm:ss type: string example: '14:00:00' end_date: description: The latest date associated with the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-07' end_time: description: Based upon the local time at the stop, the last time the load is available. Supports the format hh:mm:ss type: string example: '20:00:00' raw_address: description: A string version of the full address type: string example: 23, Phoenix is_schedule_required: description: Determines if a shipper will allow the carrier to schedule an appointment on their behalf. Not recommended for the marketplace workflow type: boolean deprecated: true example: false location_object: description: The location address details. type: object required: - address1 - city - state - country - postal_code properties: name: description: Name for the location. type: string example: Stone Brewing Company address1: description: Address1 line for the location. type: string example: 3665 North Harbor Drive address2: description: Address2 line for the location. type: string example: Suite 3100 city: description: City of the location. type: string example: San Diego state: description: State of the location. Use abbreviation. type: string example: CA country: description: Country of the location. Use abbreviation US or USA for United States of America and CA or CAN for Canada. type: string example: US postal_code: description: Postal code of the location. Supports upto 10 characters. type: string example: '92101' raw_address: description: Raw address of the location. type: string example: Stone Brewing Company, 3665 North Harbor Drive, Suite 3100, San Diego, CA, 92101, US latitude: description: Latitude of the location (use Decimal Degrees form) type: number example: 32.7325 longitude: description: Longitude of the location (use Decimal Degrees form) type: number example: -117.2011 request_load_type_id_object: description: The load type identifier. type: string enum: - FTL example: FTL load_type_id_object: description: The load type identifier. type: string enum: - FTL: 1 example: 1 request_equipment_type_id_object: description: The equipment type identifier. type: string enum: - Other - Flatbed - Reefer - Stepdeck - Rgn - Van - Drayage - Dump - VanOrReefer - TrailerPoolInterchange - PowerOnly - Conestoga - MaxiTrailer - Intermodal - BoxTruck - Hotshot - SprinterVan - StraightTruck example: Van equipment_type_id_object: description: The equipment type identifier. type: string enum: - Other: 0 - Flatbed: 1 - Reefer: 3 - Stepdeck: 4 - Rgn: 5 - Van: 6 - Drayage: 7 - Dump: 8 - VanOrReefer: 9 - TrailerPoolInterchange - 10 - PowerOnly: 11 - Conestoga: 12 - MaxiTrailer: 38 - Intermodal: 82 - BoxTruck: 84 - Hotshot: 85 - SprinterVan: 86 - StraightTruck: 87 example: 6 tags_object: description: Tags specific to the entity. type: array items: type: string example: firstTag 200_getawards_partner_response: type: object description: 200 | OK. Details of the partner winning the award properties: partner_code: description: Partner code of the winning partner as assigned by shipment provider. type: string example: P2314534 transportation_entity: description: Details of the transportation entity associated with the winning partner . type: object properties: legal_name: description: Transportation entity legal name. type: integer example: name dba_name: description: Transportation entity dba name. type: string example: testName dot_number: description: Transportation entity DOT number. type: integer example: 2894801 docket_number: description: Transportation entity Docket number. type: string example: MC143583 type: description: Transportation entity type. type: string example: testType contact: description: Contact information of the winning partner. type: object properties: first_name: description: First name of the contact. type: string example: FirstName last_name: description: Last name of the contact. type: string example: LastName email: description: Email of the contact. type: string format: email example: example@emergetms.com phone: description: Phone details of the contact. $ref: '#/components/schemas/phone_response_object' 200_getoption_partner_response: type: object description: Details of the partner associated with the option properties: partner_code: description: Partner code of partner. type: string example: P2314534 transportation_entity: description: Details of the transportation entity associated with the partner. type: object properties: legal_name: description: Transportation entity legal name. type: integer example: Hansal Transport dba_name: description: Transportation entity dba name. type: string example: HansalTransport dot_number: description: Transportation entity DOT number. type: integer example: 2894801 docket_number: description: Transportation entity Docket number. type: string example: MC143583 type: description: Transportation entity type. type: string example: testType contact: description: Contact information of the winning partner. type: object properties: first_name: description: First name of the contact. type: string example: FirstName last_name: description: Last name of the contact. type: string example: LastName email: description: Email of the contact. type: string format: email example: example@emergetms.com phone: description: Phone details of the contact. $ref: '#/components/schemas/phone_response_object' 200_sendrequest_partners_response: type: array items: type: object properties: partner_id: description: Id of the network partner to whom request could not be sent. type: integer example: 3456 partner_code: description: Partner code of the network partner to whom request could not be sent. type: string example: AS1234 error: description: Reason for not sending the request. type: string example: The request cannot be processed as the request is already sent or the option has been received for the given partner id/code. webhooks: type: object description: Details of the webhook. required: - url - content_type - event_types properties: authentication: description: Credentials that Emerge system will send using Basic authentication scheme when calling the webhook for the subscribed event(s). type: object properties: is_enabled: description: Authentication user status . type: boolean default: false example: true username: description: Authentication username. type: string example: username password: description: Authentication password. type: string example: password custom_headers: description: An object containing a set of key-value pairs. For each pair defined in this object, a custom HTTP header is sent in the webhook call for the subscribed event(s). The key becomes the header name, while the value is added as the header value. A possible use case for this feature is when the customer expects each webhook call to have a security key for authentication on their end. type: object example: x-api-key: 070C895C-AE61-4629-A603-829FC54CD816 form_data: type: object description: Object to define the form data format when content type is FormData. properties: payload_property_name: description: FormData property name for the payload type: string example: payload payload_type: description: The payload data format when content type is FormData type: string default: JSON enum: - JSON - XML addon_properties: description: A simple JSON object containing a set of key-value pairs. Each of these key-value pairs will be added to the webhook call payload in addition to the event data information. type: object example: process_id: 34809f4d-75b1-431e-a367-bea47e48636c content_type: description: Request content type. type: string enum: - application/json - application/x-www-form-urlencoded event_types: description: Subscribed event types for the webhook. Note that the API allows multiple subscriptions for any given event type(s) without any duplicate subscription checks. Although this flexibility is required by some consumers for handling certain special cases, duplicate subscription is not recommended in general and should be safeguarded against. If a consumer receives duplicate webhook calls for a single event, a duplicate webhook subscribed by mistake could be the root cause. type: array items: $ref: '#/components/schemas/webhook_event_types' is_enabled: description: Flag to control publishing of the events on webhook Url. type: boolean default: false example: true url: description: URL of the webhook as hosted by the consumer (shipper organization). type: string example: webhook_url 201_createwebhook_response: type: object description: 201 | Success. Details of the webhook properties: response: description: Response of the webhook creation. type: object properties: authentication: description: Credentials that Emerge system will send using Basic authentication scheme when calling the webhook for the subscribed event(s) type: object properties: is_enabled: description: Authentication user status . type: boolean example: true username: description: Authentication username. type: string example: username password: description: Authentication password. type: string example: password custom_headers: description: An object containing a set of key-value pairs. For each pair defined in this object, a custom HTTP header is sent in the webhook call for the subscribed event(s). The key becomes the header name, while the value is added as the header value. A possible use case for this feature is when the customer expects each webhook call to have a security key for authentication on their end. type: object example: x-api-key: 070C895C-AE61-4629-A603-829FC54CD816 form_data: type: object description: Object to define the form data format when content type is FormData. properties: payload_property_name: description: FormData property name for the payload type: string example: payload payload_type: description: The payload data format when content type is FormData type: string default: JSON enum: - JSON - XML addon_properties: description: A simple JSON object containing a set of key-value pairs. Each of these key-value pairs will be added to the webhook call payload in addition to the event data information. type: object example: process_id: 34809f4d-75b1-431e-a367-bea47e48636c content_type: description: Request content type. type: string enum: - application/json - application/x-www-form-urlencoded event_types: description: Subscribed event types for the webhook. Note that the API allows multiple subscriptions for any given event type(s) without any duplicate subscription checks. Although this flexibility is required by some consumers for handling certain special cases, duplicate subscription is not recommended in general and should be safeguarded against. If a consumer receives duplicate webhook calls for a single event, a duplicate webhook subscribed by mistake could be the root cause. type: array items: $ref: '#/components/schemas/webhook_event_types' id: description: Guid of the webhook. type: string example: 2bc9eec8-0a66-4e0f-9103-ff4f6ad4ae68 is_enabled: description: Status of the webhook. type: boolean example: true url: description: URL of the webhook as hosted by the consumer (shipper organization). type: string example: webhook_url created_date: description: Created date of the webhook. type: string example: '2019-02-12T02:36:54.2973188+00:00' modified_date: description: Modified date of the webhook. type: string example: '2019-02-12T02:36:54.2973188+00:00' error: $ref: '#/components/schemas/errorcode_zero' 200_getwebhooks_response: type: object description: 200 | OK. Details of the webhook properties: response: description: Response of the webhook creation. type: array items: type: object properties: authentication: description: Credentials that Emerge system will send using Basic authentication scheme when calling the webhook for the subscribed event(s) type: object properties: is_enabled: description: Authentication user status . type: boolean example: true username: description: Authentication username. type: string example: username password: description: Authentication password. type: string example: password custom_headers: description: An object containing a set of key-value pairs. For each pair defined in this object, a custom HTTP header is sent in the webhook call for the subscribed event(s). The key becomes the header name, while the value is added as the header value. A possible use case for this feature is when the customer expects each webhook call to have a security key for authentication on their end. type: object example: x-api-key: 070C895C-AE61-4629-A603-829FC54CD816 form_data: type: object description: Object to define the form data format when content type is FormData. properties: payload_property_name: description: FormData property name for the payload type: string example: payload payload_type: description: The payload data format when content type is FormData type: string default: JSON enum: - JSON - XML addon_properties: description: A simple JSON object containing a set of key-value pairs. Each of these key-value pairs will be added to the webhook call payload in addition to the event data information. type: object example: process_id: 34809f4d-75b1-431e-a367-bea47e48636c content_type: description: Request content type. type: string enum: - application/json - application/x-www-form-urlencoded event_types: description: Subscribed event types for the webhook. Note that the API allows multiple subscriptions for any given event type(s) without any duplicate subscription checks. Although this flexibility is required by some consumers for handling certain special cases, duplicate subscription is not recommended in general and should be safeguarded against. If a consumer receives duplicate webhook calls for a single event, a duplicate webhook subscribed by mistake could be the root cause. type: array items: $ref: '#/components/schemas/webhook_event_types' id: description: guid of the webhook. type: string example: 2bc9eec8-0a66-4e0f-9103-ff4f6ad4ae68 is_enabled: description: Status of the webhook. type: boolean example: true url: description: URL of the webhook as hosted by the consumer (shipper organization). type: string example: webhook_url created_date: description: Created date of the webhook. type: string example: '2019-02-12T02:36:54.2973188+00:00' modified_date: description: Modified date of the webhook. type: string example: '2019-02-12T02:36:54.2973188+00:00' error: $ref: '#/components/schemas/errorcode_zero' 200_getwebhook_response: type: object description: 200 | OK. Details of the webhook properties: response: description: Response of the webhook. type: object properties: authentication: description: Credentials that Emerge system will send using Basic authentication scheme when calling the webhook for the subscribed event(s). type: object properties: is_enabled: description: Authentication user status . type: boolean example: true username: description: Authentication username. type: string example: username password: description: Authentication password. type: string example: password custom_headers: description: An object containing a set of key-value pairs. For each pair defined in this object, a custom HTTP header is sent in the webhook call for the subscribed event(s). The key becomes the header name, while the value is added as the header value. A possible use case for this feature is when the customer expects each webhook call to have a security key for authentication on their end. type: object example: x-api-key: 070C895C-AE61-4629-A603-829FC54CD816 form_data: type: object description: Object to define the form data format when content type is FormData. properties: payload_property_name: description: FormData property name for the payload type: string example: payload payload_type: description: The payload data format when content type is FormData type: string default: JSON enum: - JSON - XML addon_properties: description: A simple JSON object containing a set of key-value pairs. Each of these key-value pairs will be added to the webhook call payload in addition to the event data information. type: object example: process_id: 34809f4d-75b1-431e-a367-bea47e48636c content_type: description: Request content type. type: string enum: - application/json - application/x-www-form-urlencoded event_types: description: Subscribed event types for the webhook. Note that the API allows multiple subscriptions for any given event type(s) without any duplicate subscription checks. Although this flexibility is required by some consumers for handling certain special cases, duplicate subscription is not recommended in general and should be safeguarded against. If a consumer receives duplicate webhook calls for a single event, a duplicate webhook subscribed by mistake could be the root cause. type: array items: $ref: '#/components/schemas/webhook_event_types' id: description: Guid of the webhook. type: string example: 2bc9eec8-0a66-4e0f-9103-ff4f6ad4ae68 is_enabled: description: Status of the webhook. type: boolean example: true url: description: URL of the webhook as hosted by the consumer (shipper organization). type: string example: webhook_url created_date: description: Created date of the webhook. type: string example: '2019-02-12T02:36:54.2973188+00:00' modified_date: description: Modified date of the webhook. type: string example: '2019-02-12T02:36:54.2973188+00:00' error: $ref: '#/components/schemas/errorcode_zero' updatewebhook: type: object description: Details of the webhook. required: - id - content_type - event_types - url properties: authentication: description: Credentials that Emerge system will send using Basic authentication scheme when calling the webhook for the subscribed event(s). type: object properties: is_enabled: description: Authentication user status . type: boolean example: true username: description: Basic authentication username. type: string example: username password: description: Basic authentication password. type: string example: password custom_headers: description: An object containing a set of key-value pairs. For each pair defined in this object, a custom HTTP header is sent in the webhook call for the subscribed event(s). The key becomes the header name, while the value is added as the header value. A possible use case for this feature is when the customer expects each webhook call to have a security key for authentication on their end. type: object example: x-api-key: 070C895C-AE61-4629-A603-829FC54CD816 form_data: type: object description: Object to define the form data format when content type is FormData. properties: payload_property_name: description: FormData property name for the payload type: string example: payload payload_type: description: The payload data format when content type is FormData type: string default: JSON enum: - JSON - XML addon_properties: description: A simple JSON object containing a set of key-value pairs. Each of these key-value pairs will be added to the webhook call payload in addition to the event data information. type: object example: process_id: 34809f4d-75b1-431e-a367-bea47e48636c content_type: description: Request content type. type: string enum: - application/json - application/x-www-form-urlencoded event_types: description: Subscribed event types for the webhook. Note that the API allows multiple subscriptions for any given event type(s) without any duplicate subscription checks. Although this flexibility is required by some consumers for handling certain special cases, duplicate subscription is not recommended in general and should be safeguarded against. If a consumer receives duplicate webhook calls for a single event, a duplicate webhook subscribed by mistake could be the root cause. type: array items: $ref: '#/components/schemas/webhook_event_types' is_enabled: description: Flag to control publishing of the events on webhook Url. type: boolean example: true url: description: URL of the webhook as hosted by the consumer (shipper organization). type: string example: webhook_url id: description: Guid of the webhook. type: string example: 2bc9eec8-0a66-4e0f-9103-ff4f6ad4ae68 emergency_contact_object: description: Emergency contact object. type: object properties: name: description: The name of the emergency contact type: string example: testname phone: description: The contact info for the emergency contact. type: string example: 1234567890-1234 hazmat_object: description: Hazmat object. type: object properties: identification_number: description: The Id of the tender type: integer example: 12 packing_group_id: description: The hazmat packing group type: string example: '1' class_id: description: The hazmat class identifier type: string example: '50' emergency_contact: description: The emergency contact for the hazardous commodity type: object opportunities_object: type: object required: - stops - notes - commodities - load_type_id - equipment_type_id properties: assigned_user_id: description: The Id of the user that is assigned to this object within the Emerge system. //Emerge is removing this as a required value, it will default to the authenticated user// type: integer example: 34 id: description: The Emerge Id associated with the entity type: integer example: 43 length_of_haul: description: The length of haul of the shipment in miles type: integer example: 766 created_date: description: The date/time the entity was created type: string example: '2019-02-12T02:36:54.2973188+00:00' modified_date: description: The date/time the entity was updated type: string example: '2019-02-12T02:36:54.2973188+00:00' reference: description: The date/time the assignment type: string example: '433333' type_id: description: Type id of opportunity type: string example: LTL is_priced_at: description: Identify if a target rate should be applied. Defaulted to false if not provided type: boolean example: false priced_at: description: The target rate value type: integer example: 345 is_deleted: description: A flag to identify if a tender has been deleted type: boolean example: false assigned_user: description: The assigned users details. See the assigned user object for more details type: object option_count: description: Type id of opportunity type: string example: LTL shipments: description: Brief details about the shipments associated with this opportunity type: object is_posting: description: Determines if the shipment is posted or not. if not provided this defaults to false type: boolean example: true load_type_id: $ref: '#/components/schemas/load_type_id_object' equipment_type_id: $ref: '#/components/schemas/equipment_type_id_object' equipment_size: $ref: '#/components/schemas/equipment_size_object' search_in_marketplace: description: Defines if the opportunity is upon creation submitted to the Emerge marketplace. type: boolean request_all_network_partners: description: Defines if the opportunity is upon creation submitted to the network partners. type: boolean is_hot_load: description: Identifies if the load is hot. type: boolean default: false is_tracking_required: description: Defines if tracking is required on this opportunity. type: boolean default: false stops: $ref: '#/components/schemas/stops_object' commodities: $ref: '#/components/schemas/commodities_object' accessorials: $ref: '#/components/schemas/accessorials_object' references: $ref: '#/components/schemas/references_object' notes: description: Opportunity notes. type: array items: properties: note: description: The specific note for the opportunity type: string tags: $ref: '#/components/schemas/tags_object' opportunity_response_stops_schedulle_object: description: Opportunity Stops Schedule Object. type: object properties: date: description: The stop date, local to the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-06' start_time: description: The earliest time the load is available, local to the stop. Supports format hh:mm:ss type: string example: '14:00:00' end_time: description: The earliest time the load is available, local to the stop. Supports format hh:mm:ss type: string example: '20:00:00' opportunity_response_stops_contact_object: description: Opportunity Stops Contact Object. type: object properties: name: description: The contact name for the stop type: string example: name phone: description: The phone number for the contact $ref: '#/components/schemas/phone_response_object' email: description: The email for the contact type: string format: email example: example@emergetms.com options_object: description: Options Object. type: object properties: type_id: description: The type of reference. See the Option Type Object for more details type: string example: TypeId partner_id: description: The Id of the partner in the emerge system type: integer rate_pre_mile: description: The rate per mile that will be charged to the shipper. This will be generated if left empty type: number example: 551.33 availability_date: type: string example: '2021-09-21T16:17:31.8333705+00:00' created_date: type: string example: '2021-09-21T16:17:31.8333705+00:00' modified_date: type: string example: '2021-09-21T16:17:49.5156372+00:00' opportunity_id: type: integer example: 16769 id: type: integer description: The ID of the option. example: 15633 rate: description: The rate offered to the shipper in USD type: number example: 3329.64 notes: description: See the Notes object for more details type: object organization_user_request_object: description: Organization user object type: object required: - first_name - last_name - email - phone - password properties: first_name: description: First name of the organization user. type: string example: John last_name: description: Last name of the organization user. type: string example: Williams email: description: Organization user's contact email id. type: string format: email example: john.williams@abc.com phone: description: Organization user's contact phone number. $ref: '#/components/schemas/phone_request_object' password: description: Organization user's password. It must contain at least 8 characters that includes at least 1 lowercase character(a-z), 1 uppercase character(A-Z) and 1 number(0-9). type: string example: Secret123 organization_user_response_object: description: Organization user object type: object properties: user_id: description: User Identifier. type: integer example: 12 role: description: User role. type: string enum: - OrganizationAdmin - OrganizationOperation first_name: description: First name of the organization user. type: string example: John last_name: description: Last name of the organization user. type: string example: Williams email: description: Organization user's contact email id. type: string format: email example: john.williams@abc.com phone: description: Organization user's contact phone number. $ref: '#/components/schemas/phone_response_object' phone_request_object: description: Phone Object type: object required: - number properties: number: description: The 10 digit phone number. type: string example: '1234567890' extension_number: description: The extension number, supports up to 5 digits. type: string example: '1234' phone_response_object: description: Phone Object type: object properties: number: description: The 10 digit phone number. type: string example: '1234567890' extension_number: description: The extension number, supports up to 5 digits. type: string example: '1234' reference_type_object: description: Reference type Object. type: object properties: type_id: description: The type of reference. See the Option Type Object for more details type: string example: TypeId value: description: The value provided for the reference type: string created_by_user_id: description: The Id of the user that created the entity type: integer example: 551 modified_by_user_id: type: integer example: 433 created_date: type: string example: '2021-09-21T16:17:31.8333705+00:00' modified_date: type: string example: '2021-09-21T16:17:49.5156372+00:00' opportunity_id: type: integer example: 16769 id: type: integer description: The ID of the reference. example: 15633 shipment_object: description: Shipment Object. type: object properties: reference: description: The reference type: string example: reference status_id: description: The shipment status value type: integer opportunity: description: The opportunity data type: object tenders: type: object current_tender: type: object id: type: integer description: The ID of the shipment. example: 15633 tenders_object: type: object properties: assigned_user_id: description: The Id of the user that is assigned to this object within the Emerge system. //Emerge is removing this as a required value, it will default to the authenticated user// type: integer example: 34 id: description: The Emerge Id associated with the entity type: integer example: 43 length_of_haul: description: The length of haul of the shipment in miles type: integer example: 766 created_date: description: The date/time the entity was created type: string example: '2019-02-12T02:36:54.2973188+00:00' modified_date: description: The date/time the entity was updated type: string example: '2019-02-12T02:36:54.2973188+00:00' reference: description: The date/time the assignment type: string example: '433333' status_id: description: The opportunity status type for more details. type: string example: open is_deleted: description: A flag to identify if a tender has been deleted type: boolean example: false is_dispatched: description: A flag to identify if the tender has been dispatched (LTL only) type: boolean example: false assigned_user: description: The assigned users details. See the assigned user object for more details type: object partner_id: description: The Id of the partner in the emerge system type: integer example: 345 shipment_id: description: The Id of the shipment associated with this object type: integer example: 8758 rate: description: The total rate that will be charged to the shipper by the provider. For marketplace transactions please pass option_id type: number example: 345.78 created_by_user_id: description: The created user identifier type: integer example: 12 modified_by_user_id: description: The modified user identifier type: integer example: 12 assignment: description: Assignment data type: object acceptance_date: description: The modified user identifier type: string example: '2019-02-12T02:36:54.2973188+00:00' documents: description: Documents associated with the tender. See the Documents object for more details type: object opportunity_id: description: The emerge opportunity objects unique identifier type: integer example: 4333 load_type_id: $ref: '#/components/schemas/load_type_id_object' equipment_type_id: $ref: '#/components/schemas/equipment_type_id_object' equipment_size: $ref: '#/components/schemas/equipment_size_object' is_hot_load: description: Identifies if the load is hot. type: boolean default: false is_tracking_required: description: Defines if tracking is required on this opportunity. type: boolean default: false stops: $ref: '#/components/schemas/stops_object' commodities: $ref: '#/components/schemas/commodities_object' accessorials: $ref: '#/components/schemas/accessorials_object' references: $ref: '#/components/schemas/references_object' notes: $ref: '#/components/schemas/notes_object' tags: $ref: '#/components/schemas/tags_object' option_id: description: The ID of the option that is to be tendered against. type: integer example: 323324 minimum: 1 tender_stops_schedulle_object: description: tender Stops Schedule Object. type: object properties: date: description: The stop date, local to the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-06' start_time: description: The earliest time the load is available, local to the stop. Supports format hh:mm:ss type: string example: '14:00:00' end_time: description: The earliest time the load is available, local to the stop. Supports format hh:mm:ss type: string example: '20:00:00' tender_stops_contact_object: description: Opportunity Stops Contact Object. type: object properties: name: description: The contact name for the stop type: string example: name phone: description: The phone number for the contact $ref: '#/components/schemas/phone_response_object' email: description: The email for the contact type: string format: email example: example@emergetms.com tender_commodity_object: description: A description of the items to be carried by the capacity provider. type: array items: type: object required: - name - weight properties: name: description: The name and description of the commodity. type: string example: FAK weight: description: The weight of the commodity in lbs. type: integer example: 44000 quantity_unit_id: description: The type of unit the commodity is moved on. type: string enum: - Other - Pallet - Box - Crate - Bag - Coils - Drums - Reels - Rolls - TubesOrPipes - Slipsheets - Bale - Bucket - Bundle - Can - Carton - Case - Cylinder - Pail - Pieces - Skid example: Other unit_count: description: The unit count of the commodity. type: integer example: 2 piece_count: description: The piece count of the commodity. type: integer example: 24 length: description: The length of the commodity. type: integer example: 48 width: description: The width of the commodity. type: integer example: 40 height: description: The height of the commodity. type: integer example: 60 is_stackable: description: Flag identifying a stackable commodity. Default value is false. type: boolean default: false example: false is_hazmat: description: Flag identifying a stackable commodity. Default value is false. type: boolean default: true hazmat: type: object properties: identification_number: description: The hazmat identification number for the dangerous substances. type: string example: UN1000 packing_group_id: description: The packing group identifier for the hazmat load. enum: - High - Moderate - Low - None type: string example: High class_id: description: The class of the hazmat load enum: - MassExplosiveHazard - ProjectionHazard - MassFireHazard - MinorExplosionHazard - VeryInsensitiveExplosives - ExtremelyInsensitiveExplosives - FlammableGases - NonFlammableGases - PoisonousOrToxic - CombustibleLiquids - FlammableSolid - SpontaneouslyCombustibleMaterial - DangerousWhenWet - Oxidizer - OrganicPeroxide - PoisonousOrToxicMaterial - InfectiousSubstance - RadioactiveMaterial - Corrosives - MiscellaneousDangerousGoods type: string example: ExtremelyInsensitiveExplosives emergency_contact: description: The person to be contacted regarding an emergency with this Hazmat load. type: object properties: name: description: The name of the contact responsible for the hazmat load. type: string example: Adam Jacob phone: description: The phone number of the emergency contact. $ref: '#/components/schemas/phone_response_object' tender_stop_object: description: The stops associated with the tender. A tender must have at least two stops. type: array items: type: object required: - order - name - address1 - address2 - city - state - country properties: type_id: description: The type of the stop. type: string enum: - Origin - Middle - Destination appointment_type_id: description: The appointment type for the stop. type: string enum: - FCFS - Appointment address1: description: The Address1 line for the stop. type: string example: 3665 North Harbor Drive address2: description: The Address2 line for the stop. type: string city: description: The city for the stop. type: string example: San Diego contact: type: object properties: name: description: The contact name for the person at the stop. type: string example: shipper phone: description: The phone number for the contact at the stop. $ref: '#/components/schemas/phone_response_object' email: type: string format: email example: shipper@stonelogistics.com country: description: The country for the stop. Use abbreviation US/USA for United States of America and CA/CAN for Canada. type: string example: US state: description: The state for the stop. Use abbreviation. type: string example: CA postal_code: description: The postal code for the stop. type: string example: '80302' latitude: description: The latitude for the stop (use decimal representation) type: number example: 32.2333 longitude: description: The longitude for the stop (use decimal representation) type: number example: -104.23233 name: description: the name for the stop. type: string example: Stone Brewing note: description: Notes associated with the stop. type: string example: Check in with security prior to loading or unloading. order: description: The order of the stop-starting with 1. type: integer example: 1 action_type_id: description: The stop action type. type: string enum: - Pick - Drop example: Pick schedule: description: The schedule associated with the stop. type: object properties: date: description: The date associated with the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-06' start_time: description: Based upon the local time at the stop, the earliest time the load is available. Supports the format hh:mm:ss type: string example: '14:00:00' end_time: description: Based upon the local time at the stop, the last time the load is available. Supports the format hh:mm:ss type: string example: '20:00:00' raw_address: description: A string version of the full address for the stop. type: string example: 23, Phoenix is_schedule_required: description: Determines if a shipper will allow the carrier to schedule an appointment on their behalf. Not recommended for the marketplace workflow type: boolean example: true webhook_object: type: object description: Details of the webhook. properties: authentication: description: Determines the authentication type for the webhook type: object properties: is_enabled: description: Authentication user status . type: boolean example: true username: description: Authentication username. type: string example: username password: description: Authentication password. type: string example: password content_type: description: Request content type. type: string example: application/json event_types: description: Event types of webhook. type: array items: $ref: '#/components/schemas/webhook_event_types' is_enabled: description: Status of the webhook. type: boolean example: true url: description: Webhook url of the account. type: string example: webhook_url created_date: description: The date/time the entity was created type: string example: '2019-02-12T02:36:54.2973188+00:00' modified_date: description: The date/time the entity was updated type: string example: '2019-02-12T02:36:54.2973188+00:00' webhook_authentication_object: type: object description: Details of the webhook webhook_authentication_object. properties: authentication: description: Determines the authentication type for the webhook type: object properties: is_enabled: description: Authentication user status . type: boolean example: true username: description: The username used for authentication type: string example: username password: description: The password to be used for authentication type: string example: password opportunity_status: description: The Opportunity status. type: integer enum: - Open: 1 - Closed: 2 example: 1 opportunity_type: description: The Opportunity type. type: integer enum: - Quote: 1 example: 1 shipment_status: description: The Shipment status. type: integer enum: - Open: 1 - Tendered: 2 - Closed: 3 - Canceled: 4 - Covered: 5 example: 1 tender_document: description: Documents associated with the tender. See the Documents object for more details type: object properties: tender_document_type_id: description: Document type for the tender. type: string enum: - Other: 1 - ProofOfDelivery: 2 - BillOfLading: 3 - RateConfirmation: 4 - Invoice: 5 - TransportationDocuments: 6 - SignedRateConfirmation: 7 example: 2 id: description: Document Id for the tender. type: integer example: 42734 file_name: description: The file name for the tender. type: string example: Emerge-public-api11 file_extension: description: The file extension for the tender. type: string example: yaml content_type: description: The content type for the tender. type: string example: application/octet-stream size: description: The file size for the tender. type: number example: 317119 url: description: The file url for the tender. type: string example: null document_type_id: description: The document type id for the tender. type: string enum: - Internal: 1 - Integration: 2 example: 1 transportation_entity_types: description: Transportation entity types. type: string enum: - Other - Broker - Carrier - CarrierOrBroker example: CarrierOrBroker tender_status: description: The tender status. type: string enum: - Undefined: 0 - New: 1 - Accepted: 2 - Rejected: 3 - Canceled: 4 example: 1 webhook_stops_object: description: The stops associated with the opportunity. An opportunity must have at least two stops. type: array items: type: object properties: id: description: Id for the stop.. type: integer example: 3241 type_id: description: The type for the stop. type: string enum: - Origin: 1 - Middle: 2 - Destination: 3 example: 1 name: description: the Name for the stop. type: string example: Stone Brewing Company action_type_id: description: The action type for the stop. type: string enum: - Pick: 1 - Drop: 2 example: 1 sequence: description: The stop sequence. type: integer example: 1 contact: type: object properties: name: description: The contact name for the person at the stop. type: string example: Shipper phone: description: The phone number for the contact at the stop. $ref: '#/components/schemas/phone_response_object' email: type: string example: shipper@stonelogistics.com is_schedule_required: description: Determines if a shipper will allow the carrier to schedule an appointment on their behalf. Not recommended for the marketplace workflow. type: boolean example: false schedule: description: The schedule associated with the stop. type: object properties: date: description: The date associated with the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-06' start_date: description: The start date identifier. type: string example: 22020-10-06 end_date: description: The end date identifier. type: string example: '2020-10-08' start_time: description: Based upon the local time at the stop, the earliest time the load is available. Supports the format hh:mm:ss type: string example: '14:00:00' end_time: description: Based upon the local time at the stop, the last time the load is available. Supports the format hh:mm:ss type: string example: '20:00:00' time_zone: description: The time zone identifier. type: string example: '-7' time_zone_name: description: The time zone name identifier. type: string example: America/Los_Angeles ms_time_zone_name: description: The Mstime zone name identifier. type: string example: Pacific Standard Time appointment_schedule: description: The ppointment schedule associated with the stop. type: object properties: date: description: The date associated with the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-06' start_date: description: The start date identifier. type: string example: 22020-10-06 end_date: description: The end date identifier. type: string example: '2020-10-08' start_time: description: Based upon the local time at the stop, the earliest time the load is available. Supports the format hh:mm:ss type: string example: '14:00:00' end_time: description: Based upon the local time at the stop, the last time the load is available. Supports the format hh:mm:ss type: string example: '20:00:00' time_zone: description: The time zone identifier. type: string example: '-7' time_zone_name: description: The time zone name identifier. type: string example: America/Los_Angeles ms_time_zone_name: description: The Mstime zone name identifier. type: string example: Pacific Standard Time address1: description: The Address1 line for the stop. type: string example: 3665 North Harbor Drive address2: description: The Addres2 line for the stop. type: string example: string city: description: The city for the stop. type: string example: San Diego country: description: The country for the stop. Use abbreviation. type: string example: US state: description: The state of the stop. Use abbreviation. type: string example: CA postal_code: type: string example: '92101' latitude: description: The latitude for the stop (use Decimal Degrees form). type: number example: 32.7325 longitude: description: The longitude for the stop (use Decimal Degrees form). type: number example: -117.2011 appointment_type_id: description: The appointment type for the stop. type: string enum: - FCFS: 1 - Appointment: 2 example: 1 note: description: Notes associated with the stop. type: string example: Check in with security prior to loading or unloading. AddressBookLocationId: description: The Address Book Location Id. type: integer example: 1 webhook_event_types: description: Webhook event types. type: string enum: - '*' - tracking_status_updated - delivery_status_updated - stop_actual_times_updated - current_location_updated_job - current_marketplace_option - opportunity_awarded - options_changed - tender_status_updated - network_partner_updated - network_partner_deleted - opportunity_deleted - opportunity_not_awarded example: tracking_status_updated delivery_Status: description: The delivery status of the shipment. type: string enum: - Unknown: 1 - OnTime: 2 - InJeopardy: 3 - Late: 4 - Early: 5 - TrackingLost: 6 - AtRisk: 7 example: 2 tracking_shipment_object: type: object properties: id: description: The id for the shipment. type: integer example: 7298 emerge_reference: description: The emerge reference for the shipment. type: string example: S11007298 status_id: $ref: '#/components/schemas/shipment_status' opportunity_id: description: The opportunity id for the shipment. type: integer example: 7353 organization_id: description: The organization id for the shipment. type: integer example: 336 public_tracking_link: description: This feature is limited to ProcureOS Pro plans type: string example: https://app.emergemarket.io/en/publictracking/12345 tender: description: The tender associated with the shipment. type: object properties: id: description: The Emerge Id associated with the entity type: integer example: 1868 status_id: description: The opportunity status type for more details. $ref: '#/components/schemas/tender_status' load_type_id: $ref: '#/components/schemas/load_type_id_object' equipment_type_id: $ref: '#/components/schemas/equipment_type_id_object' equipment_size: $ref: '#/components/schemas/equipment_size_object' length_of_haul: description: The length of haul of the shipment in miles type: integer example: 1083 rate: description: The rate for the shipment in USD. type: number example: 190.12 rate_per_mile: description: The rate for the shipment per mile in USD. type: number example: 1.75 Customer: description: The Customer identifier. type: string partner: description: Details of the partner associated with the tender. type: object properties: id: description: Emerge system's identifier of the winning partner. type: integer example: 473 first_name: description: Network partner's first name. type: string example: mycarrier last_name: description: Network partner's last name. type: string example: test email: description: Network partner contact's email id. type: string format: email example: mycarrier.test@abc.com code: description: Network partner contact's code. type: string example: AS1234 commodities: $ref: '#/components/schemas/webhook_commodities_object' stops: $ref: '#/components/schemas/webhook_stops_object' accessorials: $ref: '#/components/schemas/accessorials_object' references: $ref: '#/components/schemas/references_object' notes: type: array items: description: This shipment is ready to go now. Please provide your best options. properties: note: description: The specific note for the tender. type: string tags: $ref: '#/components/schemas/tags_object' documents: $ref: '#/components/schemas/tender_document' assignment: description: Assignment data associated with the tender. type: object properties: id: description: Id of the assignment. type: integer example: 1086 license_plate_number: description: The license plate number of the assignment. type: string example: ABC111408 last_position_event: type: object properties: address1: description: The address 1 of the stop. type: string example: 3665 North address2: description: The address 2 of the stop. type: string example: Harbor Drive city: description: The city of the stop. type: string example: San Diego state: description: The state of the stop. type: string example: CA postal_code: description: The postal code of the stop. type: string example: '92101' country: description: The Country of the stop. type: string example: US latitude: description: Latitude of the stop (in decimal representation) type: number example: 32.7325 longitude: description: Longitude of the stop (in decimal representation) type: number example: -117.2011 stops: type: array items: type: object properties: actual_arrival: description: The date/time of actual arrival. This is a Date time offset. type: string example: '2019-07-12T02:36:54.2973188+00:00' actual_departure: description: The date/time of actual departure. This is a Date time offset. type: string example: '2019-07-14T02:36:54.2973188+00:00' estimated_delivery_date: description: The date/time of estimated delivery. This is a Date time offset. type: string example: '2019-07-15T02:36:54.2973188+00:00' delivery_status_id: $ref: '#/components/schemas/delivery_Status' is_active_stop: description: Flag identifying a stop is active. type: boolean example: true tender_stop_id: description: The tender stop id of the stop. type: integer example: 3773 sequence: description: The sequence number of the stop. type: integer example: 1 tracking_status_id: description: The Tracking status value. type: string enum: - TenderAccepted: 1 - Dispatched: 4 - InTransit: 5 - Delivered: 6 - Completed: 8 - Canceled: 9 - AtShipper: 10 - AtConsignee: 11 example: 1 last_status_update: description: The date/time in which the status update occurred. This is a Date time offset. type: string example: '2019-07-17T12:37:04.5697743+00:00' delivery_status_id: $ref: '#/components/schemas/delivery_Status' driver_phone: description: Driver contact's phone number. $ref: '#/components/schemas/phone_response_object' created_date: description: The date/time the entity was created. This is a date/time offset. type: string example: '2019-02-12T02:36:54.2973188+00:00' modified_date: description: The date/time the entity was updated. This is a date/time offset. type: string example: '2019-02-12T02:36:54.2973188+00:00' created_by_user_id: description: The created user identifier type: integer example: 1300188 modified_by_user_id: description: The modified user identifier. type: integer example: 1300188 is_driver_phone_hidden: description: Is Driver Phone Hidden of the assignment. type: boolean example: false asigned_user: description: The assigned users details. type: object properties: id: description: Id of the asigned user. type: integer example: 1300188 first_name: description: First name of the asigned user. type: string example: Kyle last_name: description: Last name of the asigned user. type: string example: Newman acceptance_date: description: The date/time modified user identifier. This is a date/time offset. type: string example: '2019-02-12T02:36:54.2973188+00:00' created_date: description: The date/time the entity was created. This is a date/time offset. type: string example: '2019-02-12T02:36:54.2973188+00:00' modified_date: description: The date/time the entity was updated. This is a date/time offset. type: string example: '2019-02-12T02:36:54.2973188+00:00' created_by_user_id: description: The created user identifier. type: integer example: 1300188 modified_by_user_id: description: The modified user identifier. type: integer example: 1300188 is_dispatched: description: A flag to identify if the tender has been dispatched (LTL only) type: boolean example: false is_tracking_required: description: A flag to identify if tracking required. type: boolean example: false is_hot_load: description: A flag to identify if hot load enabled. type: boolean example: false notes: type: array items: description: This shipment is ready to go now. Please provide your best options. properties: note: description: The specific note for the shipment. type: string webhook_commodities_object: description: A description of the items to be carried by the capacity provider. type: array items: type: object properties: id: description: The commodity identifier. type: integer default: 0 description: description: The name and description of the commodity. type: string example: FAK weight: description: The weight of the commodity in lbs. type: integer example: 100 Nmfc: description: The Nmfc of the commodity. type: string freight_class_id: description: The freight class id of the commodity. type: string enum: - FiftyFive: 1 - Sixty: 2 - SixtyFive: 3 - Seventy: 4 - SeventySevenDotFive: 5 - EightyFive: 6 - NinetyTwoDotFive: 7 - OneHundred: 8 - OneHundredTen: 9 - OneHundredTwentyFive: 10 - OneHundredFifty: 11 - OneHundredSeventyFive: 12 - TwoHundreds: 13 - TwoHundredsFifty: 14 - ThreeHundreds: 15 - FourHundreds: 16 - FiveHundreds: 17 - Fifty: 18 example: 2 unit_count: description: The unit count of the commodity. type: integer example: 10 piece_count: description: The piece count of the commodity. type: integer example: 11 length: description: The length of the commodity. type: integer example: 10 width: description: The width of the commodity. type: integer example: 11 height: description: The height of the commodity. type: integer example: 12 unit_type_id: description: The type of unit the commodity is moved on. type: string enum: - Other: 0 - Pallet: 1 - Box: 2 - Crate: 3 - Bag: 4 - Coils: 5 - Drums: 6 - Reels: 7 - Rolls: 8 - TubesOrPipes: 9 - Slipsheets: 10 - Bale: 11 - Bucket: 12 - Bundle: 13 - Can: 14 - Carton: 15 - Case: 16 - Cylinder: 17 - Pail: 18 - Pieces: 19 - Skid: 20 example: 1 is_stackable: description: Flag identifying a stackable commodity. Default value is false. type: boolean default: false example: false is_hazmat: description: Flag identifying a hazmat commodity. Default value is false. type: boolean default: false example: true hazmat: type: object properties: identification_number: description: The hazmat identification number for the dangerous substances. type: string example: UN1000 packing_group_id: description: The packing group identifier for the hazmat load. enum: - High: 1 - Moderate: 2 - Low: 3 - None: 4 type: string example: 1 class_id: description: The class of the hazmat load. enum: - MassExplosiveHazard: 1 - ProjectionHazard: 2 - MassFireHazard: 3 - MinorExplosionHazard: 4 - VeryInsensitiveExplosives: 5 - ExtremelyInsensitiveExplosives: 6 - FlammableGases: 7 - NonFlammableGases: 8 - PoisonousOrToxic: 9 - CombustibleLiquids: 10 - FlammableSolid: 11 - SpontaneouslyCombustibleMaterial: 12 - DangerousWhenWet: 13 - Oxidizer: 14 - OrganicPeroxide: 15 - PoisonousOrToxicMaterial: 16 - InfectiousSubstance: 17 - RadioactiveMaterial: 18 - Corrosives: 19 - MiscellaneousDangerousGoods: 20 type: string example: 6 emergency_contact: description: The person to be contacted regarding an emergency with this Hazmat load. type: object properties: name: description: The name of the contact responsible for the hazmat load. type: string example: Kyle Jepsen phone: description: The phone number of the emergency contact. $ref: '#/components/schemas/phone_response_object' Opportunity_Awarded_Event: type: object description: This object contains details of the Awarded option, so that the subscriber can do the subsequent actions, including tendering to it, in their own TMS. properties: id: description: The unique identifier for this event. type: string example: 60e6d639-5f61-4a0b-b563-cf4d92cec2cc timestamp: description: The date/time this event was created in the emerge application. This is a date/time offset. type: string example: '2019-07-17T12:45:11.5130697+00:00' event_type: description: The event type name. type: string example: opportunity_awarded event_data: description: This data object contains all the details associated with the event. type: object properties: award_id: description: Emerge system identifier of the Award object. type: integer example: 23423 opportunity_id: description: Emerge system identifier for the awarded opportunity. type: integer example: 3453534 option_id: description: Emerge system identifier of the winning option. type: integer example: 234234 partner_quote_reference: description: Quote reference number of the winning partner. type: string example: '234234' expiration_date: description: Expiration date of the winning option. type: string example: '2020-10-28T07:53:59.402Z' availability_date: description: Availability date of the winning option. type: string example: '2020-10-28T07:53:59.402Z' partner: description: Details of the transportation entity associated with the winning partner type: object properties: id: description: Emerge system's identifier of the winning partner. type: integer example: 42342 partner_code: description: Partner code of the winning partner as assigned by shipment provider. type: string example: AS1234 transportation_entity: description: Details of the transportation entity associated with the winning partner. type: object properties: id: description: Emerge system's identifier of the transportation entity. type: integer example: 32424 legal_name: description: Transportation entity legal name. type: string example: My Carrier Logistic dba_name: description: Transportation entity dba name. type: string example: '2894801' dot_number: description: Transportation entity DOT number. type: integer example: 938147 docket_number: description: Transportation entity Docket number. type: string example: MC456244 type: description: Network partner's type. type: string example: Broker contact: description: Contact information of the winning partner. type: object properties: first_name: description: First name of the contact. type: string example: mycarrier last_name: description: Last name of the contact. type: string example: test contact_email: description: Email of the contact. type: string format: email example: mycarrier.test@abc.com contact_phone_number: description: Phone number of the contact. type: string example: '1234567890' contact_extension_number: description: Phone number extension of the contact. type: string example: '1234' rate: description: Rate of the winning option in USD. type: number example: 300.5 rate_details: description: Rate details of the winning option. type: object properties: line_haul: description: The line haul rate. Populates when is_total_rate is false. type: number example: 400.01 estimated_line_haul: description: The estimated line haul rate. Populates when is_total_rate is true. type: number example: 200.23 estimated_fuel: description: The estimated fuel rate. type: number example: 100 is_total_rate: description: Indicates whether the rate contains fuel surcharge or not. type: boolean example: true modified_date: description: Modified date of the winning option. type: string example: '2020-10-28T07:53:59.403Z' created_date: description: Created date of the winning option. type: string example: '2020-10-28T07:53:59.403Z' notes: description: Notes on the award. type: string example: Awarded to lowest option emerge_opportunity_reference: description: Emerge reference for the awarded opportunity. type: string example: Q113453534 references: $ref: '#/components/schemas/references_object' award_method: description: Award method for the awarded opportunity. type: string enum: - Manual - AutoAward - BookItNow example: Manual Options_Changed_Event: type: object description: This object contains the list of all the options available for a particular opportunity. Showing all options or the lowest option can be controlled in the application setting. Whenever there is a change in the available option(s), this event will get triggered and notify the consumer. properties: id: description: The unique identifier for this event. type: string example: c8d20000-9bf2-98fa-79b6-08d895e1800b timestamp: description: The date/time this event was created in the emerge application. This is a date/time offset. type: string example: '2020-12-01T10:11:42.1339822+00:00' event_type: description: The event type name type: string example: options_changed event_data: description: This data object contains all the details associated with the event. type: object properties: opportunity_id: description: Emerge system identifier for the opportunity. type: integer example: 1047 references: $ref: '#/components/schemas/references_object' options: description: This data object contains all the details associated with the event. type: array items: type: object properties: opportunity_id: deprecated: true description: Emerge system identifier for the opportunity. type: integer example: 1047 option_id: description: Emerge system identifier of the option. type: integer example: 68 partner_quote_reference: description: Quote reference number of the partner. type: string example: 2 expiration_date: description: Expiration date of the option. type: string example: '2020-10-28T07:53:59.402Z' availability_date: description: Availability date of the option. type: string example: '2020-10-28T07:53:59.402Z' partner: description: Details of the partner. type: object properties: id: description: Emerge system's identifier of the winning partner. type: integer example: 1 partner_code: description: Partner code of the winning partner as assigned by shipment provider. type: string example: AS1234 transportation_entity: description: Details of the transportation entity associated with the winning partner. type: object properties: id: description: Emerge system's identifier of the transportation entity. type: integer example: 230962 legal_name: description: Transportation entity legal name. type: string example: My Carrier Logistic dba_name: description: Transportation entity dba name. type: string example: '2894801' dot_number: description: Transportation entity DOT number. type: integer example: 2877224 docket_number: description: Transportation entity Docket number. type: string example: MC965703 type: description: Transportation entity type. type: string example: Broker contact: description: Contact information of the winning partner. type: object properties: first_name: description: First name of the contact. type: string example: mycarrier last_name: description: Last name of the contact. type: string example: test contact_email: description: Email of the contact. type: string format: email example: mycarrier.test@abc.com contact_phone_number: description: Phone number of the contact. type: string example: '1234567890' contact_extension_number: description: Phone number extension of the contact. type: string example: '1234' rate: description: Rate of the option. type: number example: 300.23 is_total_rate: description: Indicates whether the rate contains fuel surcharge or not. type: boolean example: true rate_details: description: Rate details of the option. type: object properties: line_haul: description: The line haul rate. Populates when is_total_rate is false. type: number example: 400.01 estimated_line_haul: description: The estimated line haul rate. Populates when is_total_rate is true. type: number example: 200.23 estimated_fuel: description: The estimated fuel rate. type: number example: 100 modified_date: description: Modified date of the option. type: string example: '2020-10-28T07:53:59.403Z' created_date: description: Created date of the option. type: string example: '2020-10-28T07:53:59.403Z' notes: description: The award note. type: string references: $ref: '#/components/schemas/references_object' option_submission_type: description: Submission type of the option. type: string enum: - Offer - BookItNow - Contract example: Offer Tender_Status_Updated_Event: type: object description: Details of the Partner Updated_Event. properties: id: description: The unique identifier for this event. type: string example: d6400000-9bf2-98fa-1e1b-08d904ca6a9b timestamp: description: The date/time this event was created in the emerge application. This is a date/time offset. type: string example: '2021-04-21T13:36:06.8089396+00:00' event_type: description: The event type name type: string example: tender_status_updated event_data: description: This data object contains all the details associated with the event. type: object properties: new_state: type: object properties: tender_status_id: description: The tender status value, the following values are supported. $ref: '#/components/schemas/tender_status' old_state: type: object properties: tender_status_id: description: The tender status value, the following values are supported. $ref: '#/components/schemas/tender_status' tender: type: object properties: assigned_user_id: description: The assigned user id of the tender. type: integer example: 70018 partner_id: description: The partner id of the tender. type: integer example: 4 shipment_id: description: The shipment id of the tender. type: integer example: 3355 shipment_status_id: $ref: '#/components/schemas/shipment_status' load_type_id: $ref: '#/components/schemas/load_type_id_object' equipment_type_id: $ref: '#/components/schemas/equipment_type_id_object' freight_provider_organization_equipment_type_id: description: The freight provider organization equipment type id of the tender. type: integer example: 230 freight_provider_organization_equipment_type_name: $ref: '#/components/schemas/equipment_type_id_object' length_of_haul: description: The length of haul of the tender. type: integer example: 1 length_of_haul_source_id: description: The source of the length of haul calculation. Enumeration. type: string enum: - Manual: 1 - Google: 2 - Alk: 3 example: 3 is_length_of_haul_override_enabled: description: Boolean to indicate if the length of haul has been overridden. type: boolean example: false length_of_haul_result: $ref: '#/components/schemas/length_of_haul_result_object' is_tracking_required: description: The tracking required identifier. type: boolean example: false rate: description: The rate for the shipment in USD. type: number example: 876.75 rate_per_mile: description: The rate for the shipment per mile in USD. type: number example: 3.57 fuel_rate: description: The total rate for the fuel in USD. type: number example: 6.79 is_hot_load: description: The is hot load flag. type: boolean example: false option_id: description: The ID of the option associated with the tender. type: integer example: 2240 option: description: The option details. type: object properties: id: description: The ID of the option associated with the tender. type: integer example: 2240 modified_date: description: The modified date/time of option. This is a date/time offset. type: string example: '2021-09-18T20:39:20.8137938+00:00' type_id: description: The type id of option. type: string enum: - ManuallyCreated: 1 - GeneratedByLaneRate: 2 - Ltl: 4 - PostingResponse: 5 - TlConnect: 6 - TenderServiceDefault: 7 - PricingService: 8 - TenderServiceEDI: 9 - EdgeDefault: 10 example: 1 opportunity_id: description: The opportunity id of option. type: integer example: 3373 partner_id: description: The partner id of option. type: integer example: 4 rate: description: The rate of option. type: number example: 876 rate_per_mile: description: The rate per mile of option. type: number example: 3.57 fuel_rate: description: The fuel rate of option. type: number example: 6.79 is_fuel_included: description: The fuel included flag of option. type: boolean example: false line_haul_rate: description: The line haul rate of option. type: number example: 869.52 line_haul_rate_per_mile: description: The line haul rate per mile of option. type: number example: 3.35 notes: $ref: '#/components/schemas/notes_object' commodities: $ref: '#/components/schemas/commodities_object' accessorials: $ref: '#/components/schemas/accessorials_object' stops: description: The stops associated with the opportunity. An opportunity must have at least two stops. type: array items: type: object properties: id: description: The id of the stop. type: integer example: 3241 raw_address: description: A string version of the full address. type: string example: Stone Brewing Company, 3665 North Harbor Drive string, San Diego, CA, 92101, US order: description: The order identifier. type: integer example: 1 type_id: description: The type of the stop. type: string enum: - Origin: 1 - Middle: 2 - Destination: 3 example: 1 name: description: The name for the stop. type: string example: Stone Brewing Company action_type_id: description: The stop action type. type: string enum: - Pick: 1 - Drop: 2 example: 1 sequence: description: The stop sequence number. type: integer example: 1 contact: type: object properties: name: description: The contact name for the person at the stop. type: string example: Shipper phone: description: The phone number for the contact at the stop. $ref: '#/components/schemas/phone_response_object' email: type: string example: shipper@stonelogistics.com is_schedule_required: description: Determines if a shipper will allow the carrier to schedule an appointment on their behalf. Not recommended for the marketplace workflow type: boolean example: false schedule: description: The schedule associated with the stop. type: object properties: date: description: The date associated with the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-06' start_date: description: The start date identifier. type: string example: 22020-10-06 end_date: description: The end date identifier. type: string example: '2020-10-08' start_time: description: Based upon the local time at the stop, the earliest time the load is available. Supports the format hh:mm:ss type: string example: '14:00:00' end_time: description: Based upon the local time at the stop, the last time the load is available. Supports the format hh:mm:ss type: string example: '20:00:00' time_zone: description: The time zone identifier. type: string example: '-7' time_zone_name: description: The time zone name identifier. type: string example: America/Los_Angeles ms_time_zone_name: description: The Mstime zone name identifier. type: string example: Pacific Standard Time appointment_schedule: description: The ppointment schedule associated with the stop. type: object properties: date: description: The date associated with the stop. Supports yyyy-mm-dd format. type: string example: '2021-10-06' start_date: description: The start date identifier. type: string example: 22020-10-06 end_date: description: The end date identifier. type: string example: '2020-10-08' start_time: description: Based upon the local time at the stop, the earliest time the load is available. Supports the format hh:mm:ss type: string example: '14:00:00' end_time: description: Based upon the local time at the stop, the last time the load is available. Supports the format hh:mm:ss type: string example: '20:00:00' time_zone: description: The time zone identifier. type: string example: '-7' time_zone_name: description: The time zone name identifier. type: string example: America/Los_Angeles ms_time_zone_name: description: The Mstime zone name identifier. type: string example: Pacific Standard Time address1: description: The address 1 of the stop. type: string example: 3665 North Harbor Drive address2: description: The address 2 of the stop. type: string example: string city: description: The city of the stop. type: string example: San Diego country: description: The country of the stop. type: string example: US state: description: The state of the stop. type: string example: CA postal_code: type: string example: '92101' latitude: description: Latitude of the stop (decimal representation) type: number example: 32.7325 longitude: description: Longitude of the stop (decimal representation) type: number example: -117.2011 appointment_type_id: description: The appointment type. type: string enum: - FCFS: 1 - Appointment: 2 example: 1 note: description: Notes associated with the stop. type: string example: Check in with security prior to loading or unloading. AddressBookLocationId: description: The Address Book Location Id. type: integer example: 1 references: $ref: '#/components/schemas/references_object' notes: $ref: '#/components/schemas/notes_object' Network_Partner_Updated_Event: type: object description: This object contains the partner details. Whenever there is a change in the partner details this event will get triggered and notify the consumer. properties: id: description: The unique identifier for this event. type: string example: b07a0000-ff1b-0003-e106-08d909433d91 timestamp: description: The date/time this event was created in the emerge application. This is a date/time offset. type: string example: '2021-04-27T06:11:05.4316652+00:00' event_type: description: The event type name type: string example: network_partner_updated event_data: description: This data object contains all the details associated with the event. type: object properties: partner: description: This data object contains all the details associated with the event. type: object properties: partner_id: description: The network partner identifier. type: integer example: 74844 status: description: Network partner status. type: string enum: - Confirmed - AwaitingConfirmation partner_code: description: Network partner's partner code. type: string example: PAUP127 type: description: Network partner's type. type: string enum: - Network - Hidden transportation_entity: type: object properties: company_name: description: Transportation entity company name. type: string example: EDUARDO RODRIGUEZ GONZALEZ legal_name: description: Transportation entity legal name. type: string example: EDUARDO RODRIGUEZ GONZALEZ dot_number: description: Transportation entity DOT number. type: integer example: 1503353 docket_number: description: Transportation entity docket number. type: string example: MX564565 address: description: Transportation entity address. type: object properties: address: type: string example: 'DELICIAS #5789' city: type: string example: NUEVO LAREDO state: type: string example: TM postal_code: type: integer example: 88190 contact: type: object properties: first_name: description: Network partner's first name. type: string example: Emerge last_name: description: Network partner's last name. type: string example: test email: description: Network partner contact's email id. type: string format: email example: emergetest@emergetms.com phone: description: Network partner contact's phone number. $ref: '#/components/schemas/phone_response_object' tags: $ref: '#/components/schemas/tags_object' Network_Partner_Deleted_Event: type: object description: This object contains the partner details. Whenever a partner is deleted this event will get triggered and notify the consumer. properties: id: description: The unique identifier for this event. type: string example: b07a0000-ff1b-0003-e106-08d909433d91 timestamp: description: The date/time this event was created in the emerge application. This is a date/time offset. type: string example: '2021-04-27T06:11:05.4316652+00:00' event_type: description: The event type name type: string example: network_partner_deleted event_data: description: This data object contains all the details associated with the event. type: object properties: partner: description: This data object contains all the details associated with the event. type: object properties: partner_id: description: The network partner identifier. type: integer example: 74844 status: description: Network partner status. type: string enum: - Confirmed - AwaitingConfirmation partner_code: description: Network partner's partner code. type: string example: PAUP127 type: description: Network partner's type. type: string enum: - Network - Hidden transportation_entity: type: object properties: company_name: description: Transportation entity company name. type: string example: EDUARDO RODRIGUEZ GONZALEZ legal_name: description: Transportation entity legal name. type: string example: EDUARDO RODRIGUEZ GONZALEZ dot_number: description: Transportation entity DOT number. type: integer example: 1503353 docket_number: description: Transportation entity docket number. type: string example: MX564565 address: description: Transportation entity address. type: object properties: address: type: string example: 'DELICIAS #5789' city: type: string example: NUEVO LAREDO state: type: string example: TM postal_code: type: integer example: 88190 contact: type: object properties: first_name: description: Network partner's first name. type: string example: Emerge last_name: description: Network partner's last name. type: string example: test email: description: Network partner contact's email id. type: string format: email example: emergetest@emergetms.com phone: description: Network partner contact's phone number. $ref: '#/components/schemas/phone_response_object' tags: $ref: '#/components/schemas/tags_object' Current_Marketplace_Option_Event: type: object description: This object contains the current marketplace option details. Whenever there is a change in the current marketplace option this event will get triggered and notify the consumer. properties: id: description: The unique identifier for this event. type: string example: b07a0000-ff1b-0003-e106-08d909433d91 timestamp: description: The date/time this event was created in the emerge application. This is a date/time offset. type: string example: '2021-04-27T06:11:05.4316652+00:00' event_type: description: The event type name type: string example: current_marketplace_option event_data: description: This data object contains all the details associated with the event. type: object properties: count_of_active_options: description: The count of active options. type: integer example: 1 current_option: description: The current option identifier. type: object properties: id: description: The id of the option. type: integer example: 74844 opportunity_id: description: The opportunity id. type: integer example: 174344 availability_date: description: Availability date of the option. type: string example: '2020-10-28T07:53:59.402Z' modified_date: description: Modified date of the option. type: string example: '2021-10-28T07:53:59.402' created_date: description: Created date of the option. type: string example: '2021-10-28T07:53:59.402' rate: description: The rate for the shipment in USD. type: number example: 110.75 references: description: References for the opportunity. type: array items: type: object properties: type_id: description: The reference type id. type: string example: Customer value: description: The selected reference value. type: string example: CustRef123 Opportunity_Deleted_Event: type: object description: This object contains an opportunity identifier and references. Whenever an opportunity is deleted this event will get triggered and notify the consumer. properties: id: description: The unique identifier for this event. type: string example: d6400000-9bf2-98fa-9c6e-08d97107db8a timestamp: description: The date/time this event was created in the emerge application. This is a date/time offset. type: string example: '2021-09-06T06:11:05.4316652+00:00' event_type: description: The event type name type: string example: opportunity_deleted event_data: description: This data object contains all the details associated with the event. type: object properties: opportunity_id: description: The opportunity id. type: integer example: 44521 references: description: References for the opportunity. type: array items: type: object properties: type_id: description: The reference type id. type: string example: Customer value: description: The selected reference value. type: string example: CustRef433 delivery_status_updated_Event: type: object description: The tracking events share a common object structure with the exception of ‘event_data’ object, which can change slightly depending on the updates. properties: id: description: The unique identifier for this event. type: string example: 60e6d639-5f61-4a0b-b563-cf4d92cec2cc timestamp: description: The date/time this event was created in the emerge application. This is a date/time offset. type: string example: '2019-07-17T12:45:11.5130697+00:00' event_type: description: The event type name type: string example: delivery_status_updated event_data: description: This data object contains all the details associated with the event. type: object properties: new_state: description: The current state of the event object. The webhook event data state object. type: object properties: delivery_status_id: $ref: '#/components/schemas/delivery_Status' old_state: description: The previous state of this event object. The webhook event data state object. type: object properties: delivery_status_id: $ref: '#/components/schemas/delivery_Status' stop_id: description: The stop id. type: integer example: 3773 stop_sequence: description: The sequence of the stop. type: integer example: 1 shipment: $ref: '#/components/schemas/tracking_shipment_object' tracking_status_updated_Event: type: object description: The tracking events share a common object structure with the exception of ‘event_data’ object, which can change slightly depending on the updates. properties: id: description: The unique identifier for this event. type: string example: 60e6d639-5f61-4a0b-b563-cf4d92cec2cc timestamp: description: The date/time this event was created in the emerge application. This is a date/time offset. type: string example: '2019-07-17T12:45:11.5130697+00:00' event_type: description: The event type name type: string example: tracking_status_updated event_data: description: This data object contains all the details associated with the event. type: object properties: new_state: description: The current state of the event object. The webhook event data state object. type: object properties: tracking_status_id: description: The Tracking status of the shipment. type: string enum: - TenderAccepted: 1 - Dispatched: 4 - InTransit: 5 - Delivered: 6 - Completed: 8 - Canceled: 9 - AtShipper: 10 - AtConsignee: 11 example: 1 last_status_update: description: The date/time at which the status update occurred.This is a date/time offset. type: string example: '2019-07-17T12:37:04.5697743+00:00' old_state: description: The old state of the event object. The webhook event data state object. type: object properties: tracking_status_id: description: The Tracking status of the shipment. type: string enum: - TenderAccepted: 1 - Dispatched: 4 - InTransit: 5 - Delivered: 6 - Completed: 8 - Canceled: 9 - AtShipper: 10 - AtConsignee: 11 example: 1 last_status_update: description: The date/time at which the status update occurred. This is a date/time offset. type: string example: '2019-07-17T12:37:04.5697743+00:00' shipment: $ref: '#/components/schemas/tracking_shipment_object' stop_actual_times_updated_Event: type: object description: The user can be notified via this event when an actual arrival or departure information is received in the Emerge system. The old state will be an empty object if there was no previous data (on creation). properties: id: description: The unique identifier for this event. type: string example: 60e6d639-5f61-4a0b-b563-cf4d92cec2cc timestamp: description: The date/time this event was created in the emerge application. This is a date/time offset. type: string example: '2019-07-17T12:45:11.5130697+00:00' event_type: description: The event type name type: string example: stop_actual_times_updated event_data: description: This data object contains all the details associated with the event. type: object properties: new_state: description: The current state of the event object. The webhook event data state object. type: object properties: action_date: description: The date/time at which the action took place.This is a date/time offset. type: string example: '2019-07-18T17:00:00+00:00' old_state: description: The previous state of this event object. The webhook event data state object. type: object properties: action_date: description: The date/time at which the action took place. This is a date/time offset. type: string type_id: description: The stop type id. type: string enum: - Arrival: 1 - Departure: 2 example: 1 stop_id: description: The stop id. type: integer example: 3773 stop_sequence: description: The sequence number of the stop type: integer example: 1 shipment: $ref: '#/components/schemas/tracking_shipment_object' current_location_updated_Event: type: object description: The tracking events share a common object structure with the exception of ‘event_data’ object, which can change slightly depending on the updates. properties: id: description: The unique identifier for this event. This is a guid. type: string example: 60e6d639-5f61-4a0b-b563-cf4d92cec2cc timestamp: description: The date/time this event was created in the emerge application. This is a date/time offset. type: string example: '2019-07-17T12:45:11.5130697+00:00' event_type: description: The event type name type: string example: current_location_updated_job event_data: description: This data object contains all the details associated with the event. type: object properties: city: description: City of the location. type: string example: Escondido state: description: State of the location. type: string example: CA country: description: Country of the location. type: string example: US latitude: description: Latitude of the location. type: number example: 33.11565900000001 longitude: description: Longitude of the location. type: number example: -117.119979 timestamp: description: The time that this location information was received by Emerge system. This is a date/time offset. type: string example: '2019-07-17T15:47:00-07:00' shipment: $ref: '#/components/schemas/tracking_shipment_object' Opportunity_NotAwarded_Event: type: object description: This object contains an opportunity identifier and references. When an opportunity is not awarded at the end of the bid duration then this event will get triggered and notify the subscribers. properties: id: description: The unique identifier for this event. type: string example: d6400000-9bf2-98fa-9c6e-08d97107db8a timestamp: description: The date/time this event was created in the emerge application. This is a date/time offset. type: string example: '2021-09-06T06:11:05.4316652+00:00' event_type: description: The event type name type: string example: opportunity_not_awarded event_data: description: This data object contains all the details associated with the event. type: object properties: opportunity_id: description: The opportunity id. type: integer example: 44521 references: description: References for the opportunity. type: array items: type: object properties: type_id: description: The reference type id. type: string example: Customer value: description: The selected reference value. type: string example: CustRef433 responses: '400': description: 400 | Bad Request. A bad request was made. Please try again content: application/json: schema: $ref: '#/components/schemas/400_badrequest_response' '401': description: 401 | Not Authorized. The request was not authorized. Please add or refresh your authorization token '403': description: 403 | Forbidden content: application/json: schema: $ref: '#/components/schemas/403_forbidden_response' '404': description: 404 | Not Found. The requested resource was not found '409': description: 409 | Conflict. A conflict has occurred content: application/json: schema: $ref: '#/components/schemas/409_response' '429': description: 429 | Too many requests. content: application/json: schema: $ref: '#/components/schemas/429_response' '500': description: 500 | Internal Server Error content: application/json: schema: $ref: '#/components/schemas/500_response' securitySchemes: BearerAuth: type: http scheme: bearer