> ## Documentation Index
> Fetch the complete documentation index at: https://developer.orchestro.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# PostTheEvents

> This endpoint is used for recording and updating the status of shipping or transportation events.



## OpenAPI

````yaml post /raw-tracking-event
openapi: 3.0.3
info:
  title: Satge-e1-David-Sep13
  description: This is an Open API Spec file
  contact: {}
  version: 1.0.0
servers:
  - url: https://api-stage.orchestro.ai/e1/
    description: URL-e1
  - url: >-
      https://1oxp5kxlwl.execute-api.us-east-1.amazonaws.com/stg-e1/orchestro/1A75/
    description: baseURL
  - url: https://api-stage.orchestro.ai
    description: URL
security:
  - ApiKeyAuth: []
tags:
  - name: GRD
paths:
  /raw-tracking-event:
    post:
      tags:
        - GRD
      summary: PostTheEvents
      description: >-
        This endpoint is used for recording and updating the status of shipping
        or transportation events.
      operationId: PostTheEvents
      requestBody:
        description: >-
          This endpoint accepts a JSON request body that records and updates
          shipping or transportation events. The request includes details about
          the account, carrier, and event specifics like the status, location,
          and timestamp of the event.
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/rawtrackingevent_body'
            examples:
              DDEL:
                value:
                  accounts:
                    - accountNumber: AC0099
                      accountType: CARRIER
                  carrierCode: SA21
                  event:
                    alternateStatusCode: ''
                    city: Roxbury
                    comments: ADD_COMMENTS
                    deliverySignature: 'No'
                    latitude: -72.669701
                    longitude: 41.93792
                    state: CT
                    status: POD
                    timestamp: '2024-08-12T20:51:40-04:00'
                    timezone: CST
                    zip: '06783'
                  trackingId: P92VGW30
              DDLY:
                value:
                  accounts:
                    - accountNumber: AC0099
                      accountType: CARRIER
                  carrierCode: SA21
                  event:
                    alternateStatusCode: ''
                    city: Roxbury
                    comments: ADD_COMMENTS
                    deliverySignature: 'No'
                    latitude: -72.669701
                    longitude: 41.93792
                    state: CT
                    status: SA21 Transfer Scan
                    timestamp: '2024-08-12T20:51:40-04:00'
                    timezone: CST
                    zip: '06783'
                  trackingId: P92VGW30
              DTRM:
                value:
                  accountNumber: AC0099
                  carrierCode: SA21
                  event:
                    alternateStatusCode: ''
                    city: Roxbury
                    comments: ADD_COMMENTS
                    deliverySignature: 'No'
                    latitude: -72.669701
                    longitude: 41.93792
                    state: CT
                    status: SA21 Receive Scan
                    timestamp: '2024-08-12T20:51:40-04:00'
                    timezone: CST
                    zip: '06783'
                  trackingId: P5R8Z0LK
        required: true
      responses:
        '200':
          description: Tracking successful for DTRM / DDLY / DDEL
          headers:
            Connection:
              style: simple
              explode: false
              schema:
                type: string
                example: keep-alive
            Content-Length:
              style: simple
              explode: false
              schema:
                type: string
                example: '74'
            Date:
              style: simple
              explode: false
              schema:
                type: string
                example: Wed, 25 Sep 2024 09:43:19 GMT
            Via:
              style: simple
              explode: false
              schema:
                type: string
                example: >-
                  1.1 6abe75693666356702596b0968c4d390.cloudfront.net
                  (CloudFront)
            X-Amz-Cf-Id:
              style: simple
              explode: false
              schema:
                type: string
                example: tDRemSzIiKXjr373LTLscEl6I87Q0sgj_cOJ05izB2mnqj9qXKMB4w==
            X-Amz-Cf-Pop:
              style: simple
              explode: false
              schema:
                type: string
                example: LOS50-P1
            X-Amzn-Trace-Id:
              style: simple
              explode: false
              schema:
                type: string
                example: >-
                  Root=1-66f3db37-5cec98660841cdde5b6e8f80;Parent=0cb1dd5261b57471;Sampled=0;Lineage=1:a1891311:0
            X-Cache:
              style: simple
              explode: false
              schema:
                type: string
                example: Miss from cloudfront
            x-amz-apigw-id:
              style: simple
              explode: false
              schema:
                type: string
                example: ep8wsHTWoAMEkNA=
            x-amzn-RequestId:
              style: simple
              explode: false
              schema:
                type: string
                example: 7401fba9-f36d-4ea4-8342-57a176f5641c
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/inline_response_200'
              examples:
                DDEL:
                  value:
                    correlationId: f6f440a0-bbdb-44c4-bd1d-7e3a776c192b
                    success: true
                DDLY:
                  value:
                    correlationId: cf20190c-4825-48bb-98a5-8b7cc75af230
                    success: true
                DTRM:
                  value:
                    correlationId: 9e1fd07c-095a-483f-bdac-d39b7c8800b3
                    success: true
      security:
        - ApiKeyAuth: []
components:
  schemas:
    rawtrackingevent_body:
      type: object
      properties:
        accounts:
          type: array
          description: A list of account objects associated with the event.
          example:
            - accountNumber: AC0099
              accountType: CARRIER
          items:
            $ref: '#/components/schemas/rawtrackingevent_accounts'
        carrierCode:
          type: string
          description: The code of the carrier handling the shipment.
          example: SA21
        event:
          $ref: '#/components/schemas/rawtrackingevent_event'
        trackingId:
          type: string
          description: The unique identifier for tracking the shipment.
          example: P92VGW30
    inline_response_200:
      type: object
      properties:
        correlationId:
          type: string
          example: 9e1fd07c-095a-483f-bdac-d39b7c8800b3
        success:
          type: boolean
          example: true
    rawtrackingevent_accounts:
      type: object
      properties:
        accountNumber:
          type: string
          description: The unique identifier for the account.
          example: AC0099
        accountType:
          type: string
          description: The type of account, typically either a carrier or customer.
          example: CARRIER
    rawtrackingevent_event:
      type: object
      properties:
        alternateStatusCode:
          type: string
          description: An optional alternate status code for the event, if applicable.
          example: ''
        city:
          type: string
          description: The city where the event occurred.
          example: Roxbury
        comments:
          type: string
          description: Additional comments related to the event.
          example: ADD_COMMENTS
        deliverySignature:
          type: string
          description: Indicates whether a delivery signature was required or provided.
          example: 'No'
        latitude:
          type: number
          description: The latitude coordinate of the event's location.
          example: -72.669701
        longitude:
          type: number
          description: The longitude coordinate of the event's location.
          example: 41.93792
        state:
          type: string
          description: The state where the event took place.
          example: CT
        status:
          type: string
          description: The current status of the shipment.
          example: POD
        timestamp:
          type: string
          description: The timestamp of when the event occurred, in ISO 8601 format.
          example: '2024-08-12T20:51:40-04:00'
        timezone:
          type: string
          description: The timezone in which the event occurred.
          example: CST
        zip:
          type: string
          description: The ZIP code where the event took place.
          example: '06783'
      description: Details of the shipping or transportation event being recorded.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: Authorization
      in: header

````