---
title: "Sync one"
method: POST
path: "/shipping_integrations/dispatch_science/orders/sync_one/v1"
tags: ["/shipping_integrations"]
---

# Sync one

`POST /shipping_integrations/dispatch_science/orders/sync_one/v1`

Fetches and mirrors one DispatchScience order by the provider's own order ID. | authz: min_org_role=operator | (DispatchScienceOrderSyncOneReq) -> (DispatchScienceOrder1)

## Request body

- DispatchScienceOrderSyncOneReq
  - `provider_org_id` string, required — Must be a string starting with `org_`
  - `integration_order_id` string, required

## Response `200`

Successful Response

- DispatchScienceOrder1
  - `schema_version` 1, required
  - `_id` string, required
  - `org_id` string, required — Must be a string starting with `org_`
  - `shipping_integration` 'dispatch_science', required
  - `provider_org_id` string, required — Must be a string starting with `org_`
  - `integration_order_id` string, required
  - `provider_payload` DispatchScienceOrderResponse1, required — Known fields from a DispatchScience order, retaining all other fields.
    - `orderId` string, required
    - `status` integer, required
    - `createdAt` string, nullable
    - `pickupAddress` DispatchScienceAddressResponse1
      - `addressLine1` string, nullable
      - `addressLine2` string, nullable
      - `company` string, nullable
      - `city` string, nullable
      - `postalCode` string, nullable
      - `stateProvince` string, nullable
    - `pickupLocation` DispatchScienceLocationResponse1 — A `LatLng`. `isValid` is false when the provider could not geocode the address.
      - `latitude` number, nullable
      - `longitude` number, nullable
      - `isValid` boolean, nullable
    - `pickupTimeZone` DispatchScienceTimeZoneResponse1
      - `systemTimeZoneId` string, nullable
      - `ianaTimeZoneId` string, nullable
      - `shortDisplayName` string, nullable
      - `longDisplayName` string, nullable
      - `isDaylightSavingTime` boolean, nullable
      - `offset` number, nullable
    - `pickupContactInfo` DispatchScienceContactInfoResponse1
      - `id` string, nullable
      - `name` string, nullable
      - `phoneNumber` string, nullable
      - `email` string, nullable
      - `language` string, nullable
    - `pickupNotes` string, nullable
    - `pickupWindow` DispatchScienceTimeWindowResponse1
      - `start` string, nullable
      - `end` string, nullable
    - `dropoffAddress` DispatchScienceAddressResponse1
      - `addressLine1` string, nullable
      - `addressLine2` string, nullable
      - `company` string, nullable
      - `city` string, nullable
      - `postalCode` string, nullable
      - `stateProvince` string, nullable
    - `dropoffLocation` DispatchScienceLocationResponse1 — A `LatLng`. `isValid` is false when the provider could not geocode the address.
      - `latitude` number, nullable
      - `longitude` number, nullable
      - `isValid` boolean, nullable
    - `dropoffTimeZone` DispatchScienceTimeZoneResponse1
      - `systemTimeZoneId` string, nullable
      - `ianaTimeZoneId` string, nullable
      - `shortDisplayName` string, nullable
      - `longDisplayName` string, nullable
      - `isDaylightSavingTime` boolean, nullable
      - `offset` number, nullable
    - `dropoffContactInfo` DispatchScienceContactInfoResponse1
      - `id` string, nullable
      - `name` string, nullable
      - `phoneNumber` string, nullable
      - `email` string, nullable
      - `language` string, nullable
    - `dropoffNotes` string, nullable
    - `dropoffWindow` DispatchScienceTimeWindowResponse1
      - `start` string, nullable
      - `end` string, nullable
    - `distance` number, nullable
    - `distanceUnits` string, nullable
    - `serviceLevelId` string, nullable
    - `vehicleTypeId` string, nullable
    - `notes` string, nullable
    - `numberOfPieces` integer, nullable
    - `weight` number, nullable
    - `weightUnits` string, nullable
    - `volume` number, nullable
    - `volumeUnits` string, nullable
    - `readyAt` string, nullable
    - `receivedBy` string, nullable
    - `isOnHold` boolean, nullable
    - `referenceNumber1` string, nullable
    - `referenceNumber2` string, nullable
    - `referenceNumber3` string, nullable
    - `charges` DispatchScienceChargeResponse1[], nullable
      - `id` string, nullable
      - `type` string, nullable
      - `price` number, nullable
      - `quantity` number, nullable
      - `extraFeeTypeId` string, nullable
      - `fromZone` string, nullable
      - `toZone` string, nullable
    - `attachments` DispatchScienceAttachmentResponse1[], nullable
      - `fileName` string, nullable
      - `attachmentId` string, nullable
      - `attachmentUrl` string, nullable
      - `isUploaded` boolean, nullable
      - `includeWithInvoice` boolean, nullable
      - `visibleForDriver` boolean, nullable
      - `note` string, nullable
      - `type` integer, nullable
      - `createdAt` string, nullable
  - `provider_payload_hash` string, required
  - `created_at_timestamp` string, date-time, required
  - `updated_at_timestamp` string, date-time, required
  - `mirrored_at_timestamp` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/chrt/apis/chrt-fastapi.md) · [All operations](https://skmtc.dev/chrt/apis/chrt-fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/chrt/chrt-fastapi/revisions/ea04e157edb3/schema)