# Get billing group by id

Endpoint: GET /billingGroups/{billingGroupId}/details
Version: 1.0.0
Security: M2X_auth_application

## Path parameters:

  - `billingGroupId` (string, required)
    The billing group Id

## Response 200 fields (application/json):

  - `id` (string)

  - `humanReadableId` (string)

  - `branches` (array)

  - `branches.name` (string,null)

  - `branches.externalId` (string,null)

  - `customerId` (string,null)

  - `customerName` (string,null)

  - `customerIntegrationId` (string,null)
    Customer integration id for this job

  - `customerExternalId` (string,null)
    External customer id for this job

  - `crnNumberByCustomerId` (object,null)
    Key value store of customer id and crn

  - `inactive` (boolean)

  - `status` (string)

  - `date` (string)

  - `properties` (object,null)
    A key value store containing custom properties

  - `jobs` (array)

  - `jobs.shortNote` (string)

  - `jobs.updated` (string)

  - `jobs.created` (string)

  - `jobs.deleted` (boolean)

  - `jobs.attachments` (array)

  - `jobs.bookedBy` (object)

  - `jobs.bookedBy.uid` (string)

  - `jobs.bookedBy.email` (string)

  - `jobs.updatedBy` (object)

  - `jobs.reconciledBy` (object)

  - `jobs.deletedBy` (object)

  - `jobs.deliveryReference` (string)
    A reference added by the dispatcher

  - `jobs.truckReference` (string)
    A reference added by the driver, e.g. docket number

  - `jobs.senderReference` (string,null)
    A reference added by the dispatcher

  - `jobs.receiverReference` (string,null)
    A reference added by the dispatcher

  - `jobs.truckSenderReference` (string,null)
    A reference added by the driver at pickup, e.g. weighbridge docket number

  - `jobs.truckReceiverReference` (string,null)
    A reference added by the driver at delivery, e.g. weighbridge docket number

  - `jobs.truckPickupBoLReference` (string,null)
    A Bill of Lading reference added by the driver at pickup, e.g. Bill of Lading number

  - `jobs.truckDeliveryBoLReference` (string,null)
    A Bill of Lading reference added by the driver at delivery, e.g. Bill of Lading number

  - `jobs.pickupDistanceReadingKm` (number,null)

  - `jobs.deliveryDistanceReadingKm` (number,null)

  - `jobs.distanceReadingDeltaKm` (number,null)
    The odometer distance difference between pickup and delivery

  - `jobs.pickupEngineHoursReading` (number,null)

  - `jobs.deliveryEngineHoursReading` (number,null)

  - `jobs.engineReadingDeltaHours` (number,null)
    The engine hours difference between pickup and delivery

  - `jobs.orderId` (string)

  - `jobs.orderFriendlyName` (string)

  - `jobs.bookingId` (string)
    If the job is linked to a corporate booking, the bookingId

  - `jobs.customerId` (string)
    The M2X customer id for this job

  - `jobs.customerName` (string)
    Customer name for this job

  - `jobs.billingGroupId` (string)
    Billing Group for this job

  - `jobs.humanReadableId` (string)
    Human Readable Id for this Billing group

  - `jobs.billingGroupStatus` (string)
    Billing Group status for this job

  - `jobs.pickupLocation` (object)

  - `jobs.pickupLocation.addressText` (string, required)

  - `jobs.pickupLocation.latitude` (number, required)

  - `jobs.pickupLocation.longitude` (number, required)

  - `jobs.pickupLocation.locationName` (string, required)

  - `jobs.pickupLocation.locationId` (string,null)
    The M2X internal location id. When a location is manually created in M2X, this is a randomly generated unique identifier. If creating locations via API, the caller can set the Location ID.

  - `jobs.pickupLocation.externalId` (string,null)
    An optional external identifier assigned to the location. This ID can be provided when creating the location and is typically used for cross-system referencing or integration with external data sources.

  - `jobs.pickupLocation.timezone` (string)
    IANA (aka TZ database) timezone name
    Example: "Pacific/Auckland"

  - `jobs.pickupLocation.properties` (object,null)

  - `jobs.pickupRegions` (object)

  - `jobs.pickupRegions.dispatchRegionIds` (array)

  - `jobs.taskPickupTimestamp` (string)
    RFC3339 date time of the pickup

  - `jobs.taskStartPickupTimestamp` (string)
    RFC3339 date time of arrival at the pickup site

  - `jobs.taskEndPickupTimestamp` (string)
    RFC3339 date time of departure from the pickup site

  - `jobs.deliveryLocation` (object)

  - `jobs.deliveryRegions` (object)

  - `jobs.taskDeliveryTimestamp` (string)
    RFC3339 date time of the delivery

  - `jobs.taskStartDeliveryTimestamp` (string)
    RFC3339 date time of arrival at the delivery site

  - `jobs.taskEndDeliveryTimestamp` (string)
    RFC3339 date time of departure from the delivery site

  - `jobs.dispatchHub` (object)
    If the job was created from dispatch hub, the associated details

  - `jobs.dispatchHub.activityId` (string)

  - `jobs.dispatchHub.workId` (string)

  - `jobs.dispatchHub.type` (string)

  - `jobs.dispatchHub.subtypes` (array)

  - `jobs.dynamicFulfilment` (object)
    If the job was created from dynamic fulfilment, the associated details

  - `jobs.dynamicFulfilment.shiftId` (string)

  - `jobs.dynamicFulfilment.serviceDay` (string)

  - `jobs.dynamicFulfilment.pickupTaskId` (string)

  - `jobs.dynamicFulfilment.pickupConstraintId` (string)

  - `jobs.dynamicFulfilment.deliveryTaskId` (string)

  - `jobs.dynamicFulfilment.deliveryConstraintId` (string)

  - `jobs.dynamicFulfilment.dispatchGroupId` (string)

  - `jobs.vehicleId` (string)

  - `jobs.vehicleExternalId` (string)

  - `jobs.vehicleProperties` (object)

  - `jobs.assets` (object)

  - `jobs.assets.driver` (object)

  - `jobs.assets.driver.assetId` (string)
    uid for this asset

  - `jobs.assets.tractorUnit` (object)

  - `jobs.assets.trailers` (array)

  - `jobs.assets.miscAssets` (array)

  - `jobs.assets.isoContainers` (array)

  - `jobs.subcontractorId` (string)

  - `jobs.subcontractorExternalId` (string)

  - `jobs.subcontractorProperties` (object)

  - `jobs.transportRequirementsId` (string)
    M2X internal tracking id for the product type

  - `jobs.division` (string,null)
    The division of the job (e.g. bulk, general, livestock...)

  - `jobs.productCode` (string,null)
    M2X internal tracking id for the product code used

  - `jobs.productCodeName` (string,null)
    M2X name for the product code used

  - `jobs.productCodeExternalId` (string,null)
    External Id for product tracking

  - `jobs.productProperties` (object)

  - `jobs.productComponents` (array)
    The sub components of the product if present

  - `jobs.productComponents.proportion` (number)
    The percentage proportion of this component

  - `jobs.productComponents.quantity` (number)

  - `jobs.productComponents.description` (string)

  - `jobs.productComponents.product` (object)
    A component for a product

  - `jobs.productComponents.product.productCodeName` (string,null)
    Friendly name of the product code

  - `jobs.quantity` (number)
    The product quantity

  - `jobs.distanceKm` (number)
    The reference distance for the job

  - `jobs.precisionPrice` (number,null)
    The precision price for the job

  - `jobs.precisionTkm` (number,null)
    The precision tonne km for the job

  - `jobs.precisionKm` (number,null)
    The precision price for the job

  - `jobs.precisionHr` (number,null)
    The precision Hr for the job

  - `jobs.invoicable` (boolean)
    Whether the job is invoiceable or not

  - `jobs.priceTransport` (number,null)
    The allocated transport price

  - `jobs.priceFaf` (number,null)
    The allocated FAF

  - `jobs.podLink` (string,null)
    The link to the track and trace POC link

  - `jobs.pocLink` (string,null)
    The link to the track and trace POD link

  - `jobs.pod` (object)
    Task completion details, e.g. proof of delivery

  - `jobs.pod.pickup` (object)

  - `jobs.pod.pickup.signedBy` (string,null)
    Name of person signing (accepting responsibility)
    Example: "John Doe"

  - `jobs.pod.pickup.completedBy` (object,null)
    User that carried out this operation, e.g. Driver

  - `jobs.pod.pickup.completedBy.id` (string)
    The external user identifier for driver/device if set, otherwise the M2X internal userId

  - `jobs.pod.pickup.completedBy.name` (string,null)
    Human readable name of user, e.g. Driver's name

  - `jobs.pod.pickup.downloadUrl` (string,null)
    URL where proof of delivery PDF can be downloaded from
    Example: "https://m2x.app/apis/v0/resources/generalConsignments/TGX854-6OU9Ns9xm9E4JxP1YJYs-1670743772224/pod/pdf"

  - `jobs.pod.delivery` (object)

  - `jobs.booked` (object)

  - `jobs.booked.pickupTimestamp` (integer)
    Epoch timestamp (seconds since 1970) of the booked pickup

  - `jobs.booked.deliveryTimestamp` (integer)
    Epoch timestamp (seconds since 1970) of the booked delivery

  - `jobs.booked.productId` (string)
    M2X internal tracking id for the booked product type

  - `jobs.booked.productCode` (string,null)
    M2X internal tracking id for the booked product code used

  - `jobs.booked.quantity` (number)
    The booked product quantity

  - `jobs.booked.distanceKm` (number)
    The reference distance for the booked job

  - `jobs.docketMeasurementProperties` (object,null)
    A key value store containing docket measurement properties

  - `jobs.cancellationNotes` (string,null)
    Notes for the job cancellation

  - `jobs.cancellationReason` (string,null)
    Reason for the job cancellation

  - `jobs.pickupTimestamp` (integer)
    Epoch timestamp (seconds since 1970) of the pickup

  - `jobs.deliveryTimestamp` (integer)
    Epoch timestamp (seconds since 1970) of the delivery

  - `transportRevenues` (array)

  - `transportRevenues.revenueId` (string)

  - `transportRevenues.revenueGroupId` (string,null)

  - `transportRevenues.priceTotal` (number)

  - `transportRevenues.timestamp` (string,null)
    Date of the revenue (transport/storage etc)

  - `transportRevenues.updated` (string,null)
    Date the revenue was updated

  - `transportRevenues.referenceCodes` (array,null)

  - `transportRevenues.vehicleReferenceCodes` (array,null)

  - `transportRevenues.vehiclePickupBoLReferences` (array)

  - `transportRevenues.vehicleDeliveryBoLReferences` (array)

  - `transportRevenues.massKg` (number,null)

  - `transportRevenues.unitName` (string)

  - `transportRevenues.spatialRequirements` (number,null)
    Could represent many dimensions, cube for bulk, area for livestock etc

  - `transportRevenues.productDescription` (string)

  - `transportRevenues.product` (object)
    A product

  - `transportRevenues.product.productInvoiceName` (string,null)
    Invoice name of the product code

  - `transportRevenues.priceFaf` (number)

  - `transportRevenues.priceTransport` (number)

  - `transportRevenues.priceTransportDetail` (any)

  - `transportRevenues.priceFafDetail` (any)

  - `transportRevenues.transportChargeId` (string,null)

  - `transportRevenues.transportChargeName` (string,null)

  - `storageRevenues` (array)

  - `storageRevenues.storageLocation` (object)

  - `productRevenues` (array)

  - `productRevenues.sourceLocation` (object)

  - `manualRevenues` (array)

  - `manualRevenues.miscChargeId` (string,null)

  - `manualRevenues.miscChargeName` (string,null)

  - `manualRevenues.priceTotalDetail` (any)

## Response 404 fields (application/json):

  - `message` (string)
    Example: "not found"