---
title: "Create capacity"
method: POST
path: "/api/v2/capacity"
tags: ["Capacity"]
---

# Create capacity

`POST /api/v2/capacity`

Inform us about a list of available trucks.

The available trucks must have at least a point of pickup, the
delivery is not mandatory but will increase the chances of best
matching for our loads.

The capacity represents an empty truck position. For different
empty positions for the same truck, the available trucks and
their ids must be different. We suggest that you use an uuid to
represent the `ref_number` attribute on your side, because this
identifier will be reused across other endpoints.

## Request body

- union
  - object[]
    - `available_at` string, date-time, required — The date and time the truck is going to be available. You must not provide timezone info.
    - `delivery_deadhead` number — The distance between the truck and the delivery
    - `pickup_deadhead` number — The distance between the truck and the pickup
    - `expires_at` string, date-time
    - `carrier_identification` union, required — An identifier for the carrier. There are two ways to identify a carrier, by Loadsmart Carrier ID or by MC+DOT combination. If you provide carrier ID, you must not provide any information for MC and DOT. If you provide MC and DOT, you must not provide carrier ID information.
      - object
        - `carrier_id` string, uuid, required — Carrier UUID (provided by Loadsmart)
        - `mc` string — Carrier MC Number (Motor Carrier Number)
        - `dot` string — Carrier DOT Number
      - object
        - `carrier_id` string, uuid — Carrier UUID (provided by Loadsmart)
        - `mc` string, required — Carrier MC Number (Motor Carrier Number)
        - `dot` string, required — Carrier DOT Number
    - `ref_number` string, required — Unique id for the given capacity, this must represent the id for this capacity on your side. This represents the empty truck location identifier. You must use different ids for different empty locations or dates, even if its the same capacity/truck. We suggest that you use an uuid to create this identifier.
    - `fleet_id` string — Fleet identifier for this capacity.
    - `equipment_type` 'DRV' | 'FBE' | 'RFR' | 'CON' | 'CUR' | 'DDP' | 'IMC' | 'SDK' | 'STK', required — Truck's type. Must be one of the following: `DRV` for Dry Van `FBE` for Flatbed `RFR` for Reefer `CON` for Conestoga `CUR` for Curtainside `DDP` for Double Drop `IMC` for Intermodal `SDK` for Step Deck `STK` for Straight Truck
    - `rate` number — The all in rate for the lane.
    - `rate_per_mile` number — Indicates the value per miles
    - `is_backhaul` boolean — Indicates whether the capacity is backhaul or not.
    - `contacts` object[] — A list of who should be contacted by us for this capacity.
      - `name` string
      - `phone_number` string — Phone number following the format [E.164](https://www.itu.int/rec/T-REC-E.164/)
      - `email` string
    - `pickup` union, required — The desired location for pickup. Certain parameters are required for this request. You must include either zipcode, state or coords. If you provide coords, you must not provide any other address information. If you include a City, then a State should also be provided to avoid ambiguous information. Missing geographical data will be automatically filled by the API.
      - object
        - `city` string — Name of city
        - `state` string, required — Two letter state or equivalent administrative boundary
        - `zipcode` string — zipcode (first five digits)
        - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
        - `coords` object
          - `latitude` number, required — Approximate latitude for the place
          - `longitude` number, required — Approximate longitude for the place
      - object
        - `city` string — Name of city
        - `state` string — Two letter state or equivalent administrative boundary
        - `zipcode` string, required — zipcode (first five digits)
        - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
        - `coords` object
          - `latitude` number, required — Approximate latitude for the place
          - `longitude` number, required — Approximate longitude for the place
      - object
        - `city` string, required — Name of city
        - `state` string, required — Two letter state or equivalent administrative boundary
        - `zipcode` string — zipcode (first five digits)
        - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
        - `coords` object
          - `latitude` number, required — Approximate latitude for the place
          - `longitude` number, required — Approximate longitude for the place
      - object
        - `city` string — Name of city
        - `state` string — Two letter state or equivalent administrative boundary
        - `zipcode` string — zipcode (first five digits)
        - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
        - `coords` object, required
          - `latitude` number, required — Approximate latitude for the place
          - `longitude` number, required — Approximate longitude for the place
    - `delivery` union[] — The desired location for delivery. Certain parameters are required for this request. You must include either zipcode, state or coords. If you provide coords, you must not provide any other address information. If you include a City, then a State should also be provided to avoid ambiguous information. Missing geographical data will be automatically filled by the API.
      - union
        - object
          - `city` string — Name of city
          - `state` string, required — Two letter state or equivalent administrative boundary
          - `zipcode` string — zipcode (first five digits)
          - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
          - `coords` object
            - `latitude` number, required — Approximate latitude for the place
            - `longitude` number, required — Approximate longitude for the place
        - object
          - `city` string — Name of city
          - `state` string — Two letter state or equivalent administrative boundary
          - `zipcode` string, required — zipcode (first five digits)
          - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
          - `coords` object
            - `latitude` number, required — Approximate latitude for the place
            - `longitude` number, required — Approximate longitude for the place
        - object
          - `city` string, required — Name of city
          - `state` string, required — Two letter state or equivalent administrative boundary
          - `zipcode` string — zipcode (first five digits)
          - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
          - `coords` object
            - `latitude` number, required — Approximate latitude for the place
            - `longitude` number, required — Approximate longitude for the place
        - object
          - `city` string — Name of city
          - `state` string — Two letter state or equivalent administrative boundary
          - `zipcode` string — zipcode (first five digits)
          - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
          - `coords` object, required
            - `latitude` number, required — Approximate latitude for the place
            - `longitude` number, required — Approximate longitude for the place
  - object[]
    - `available_dow` string[], required — A list of the capacity's available days of week.
    - `carrier_identification` union, required — An identifier for the carrier. There are two ways to identify a carrier, by Loadsmart Carrier ID or by MC+DOT combination. If you provide carrier ID, you must not provide any information for MC and DOT. If you provide MC and DOT, you must not provide carrier ID information.
      - object
        - `carrier_id` string, uuid, required — Carrier UUID (provided by Loadsmart)
        - `mc` string — Carrier MC Number (Motor Carrier Number)
        - `dot` string — Carrier DOT Number
      - object
        - `carrier_id` string, uuid — Carrier UUID (provided by Loadsmart)
        - `mc` string, required — Carrier MC Number (Motor Carrier Number)
        - `dot` string, required — Carrier DOT Number
    - `ref_number` string, required — Unique id for the given capacity, this must represent the id for this capacity on your side. This represents the empty truck location identifier. You must use different ids for different empty locations or dates, even if its the same capacity/truck. We suggest that you use an uuid to create this identifier.
    - `fleet_id` string — Fleet identifier for this capacity.
    - `equipment_type` 'DRV' | 'FBE' | 'RFR' | 'CON' | 'CUR' | 'DDP' | 'IMC' | 'SDK' | 'STK', required — Truck's type. Must be one of the following: `DRV` for Dry Van `FBE` for Flatbed `RFR` for Reefer `CON` for Conestoga `CUR` for Curtainside `DDP` for Double Drop `IMC` for Intermodal `SDK` for Step Deck `STK` for Straight Truck
    - `rate` number — The all in rate for the lane.
    - `rate_per_mile` number — Indicates the value per miles
    - `is_backhaul` boolean — Indicates whether the capacity is backhaul or not.
    - `contacts` object[], required — A list of who should be contacted by us for this capacity.
      - `name` string
      - `phone_number` string — Phone number following the format [E.164](https://www.itu.int/rec/T-REC-E.164/)
      - `email` string
    - `pickup` union, required — The desired location for pickup. Certain parameters are required for this request. You must include either zipcode, state or coords. If you provide coords, you must not provide any other address information. If you include a City, then a State should also be provided to avoid ambiguous information. Missing geographical data will be automatically filled by the API.
      - object
        - `city` string — Name of city
        - `state` string, required — Two letter state or equivalent administrative boundary
        - `zipcode` string — zipcode (first five digits)
        - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
        - `coords` object
          - `latitude` number, required — Approximate latitude for the place
          - `longitude` number, required — Approximate longitude for the place
      - object
        - `city` string — Name of city
        - `state` string — Two letter state or equivalent administrative boundary
        - `zipcode` string, required — zipcode (first five digits)
        - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
        - `coords` object
          - `latitude` number, required — Approximate latitude for the place
          - `longitude` number, required — Approximate longitude for the place
      - object
        - `city` string, required — Name of city
        - `state` string, required — Two letter state or equivalent administrative boundary
        - `zipcode` string — zipcode (first five digits)
        - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
        - `coords` object
          - `latitude` number, required — Approximate latitude for the place
          - `longitude` number, required — Approximate longitude for the place
      - object
        - `city` string — Name of city
        - `state` string — Two letter state or equivalent administrative boundary
        - `zipcode` string — zipcode (first five digits)
        - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
        - `coords` object, required
          - `latitude` number, required — Approximate latitude for the place
          - `longitude` number, required — Approximate longitude for the place
    - `delivery` union[] — The desired location for delivery. Certain parameters are required for this request. You must include either zipcode, state or coords. If you provide coords, you must not provide any other address information. If you include a City, then a State should also be provided to avoid ambiguous information. Missing geographical data will be automatically filled by the API.
      - union
        - object
          - `city` string — Name of city
          - `state` string, required — Two letter state or equivalent administrative boundary
          - `zipcode` string — zipcode (first five digits)
          - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
          - `coords` object
            - `latitude` number, required — Approximate latitude for the place
            - `longitude` number, required — Approximate longitude for the place
        - object
          - `city` string — Name of city
          - `state` string — Two letter state or equivalent administrative boundary
          - `zipcode` string, required — zipcode (first five digits)
          - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
          - `coords` object
            - `latitude` number, required — Approximate latitude for the place
            - `longitude` number, required — Approximate longitude for the place
        - object
          - `city` string, required — Name of city
          - `state` string, required — Two letter state or equivalent administrative boundary
          - `zipcode` string — zipcode (first five digits)
          - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
          - `coords` object
            - `latitude` number, required — Approximate latitude for the place
            - `longitude` number, required — Approximate longitude for the place
        - object
          - `city` string — Name of city
          - `state` string — Two letter state or equivalent administrative boundary
          - `zipcode` string — zipcode (first five digits)
          - `country` string — 3-letter country code, uppercase (ISO 3166-1 alpha-3) If no country is provided, 'USA' is inferred.
          - `coords` object, required
            - `latitude` number, required — Approximate latitude for the place
            - `longitude` number, required — Approximate longitude for the place

## Response `202`

All provided data is valid and the available trucks are being created

## Other responses

- `422` — Payload is invalid and a capacity can't be created

---

[API](https://skmtc.dev/loadsmart/apis/loadsmart-api.md) · [All operations](https://skmtc.dev/loadsmart/apis/loadsmart-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loadsmart/loadsmart-api/revisions/6021c5806fe9/schema)