---
title: "Request Integration for a Carrier"
method: POST
path: "/api/v2/carrier/integration-request"
tags: ["Carrier"]
---

# Request Integration for a Carrier

`POST /api/v2/carrier/integration-request`

3PP can integrate a carrier and create a Carrier Account

## Request body

- object
  - `carrier_id` string, required — Carrier UUID
  - `owner` object — Company main contact information.
    - `first_name` string, required — First Name
    - `last_name` string, required — Last Name
    - `email` string, required — Email Address
    - `phone_number` string — Phone number following the format [E.164](https://www.itu.int/rec/T-REC-E.164/)
    - `phone_number_extension` string — Phone Number Extension

## Response `200`

Integration Request with same data already exists

- object
  - `id` string — Unique Identifier of the Integration Request
  - `account_id` string — Unique Identifier of the Account
  - `carrier` object
    - `id` string — Unique Identifier of the Carrier on Loadsmart
    - `mc` string — Carrier Interstate Operating Authority (MC number)
    - `dot` string — Carrier US DOT Number
    - `name` string — Carrier legal name
    - `eligible` unknown
    - `status` 'New' | 'Pending' | 'Ready' | 'Inactive' — Carrier status on Loadsmart
  - `status` 'pending' | 'accepted' | 'rejected' — Status of the Integration Request - pending: waiting/under evaluation from Carrier owner and/or Loadsmart - accepted: Integration Request accepted - rejected: Integration Request rejected by Carrier owner and/or Loadsmart
  - `documents` object[] — List of required documents and its status
    - `type` string — Document type (Form W9, Insurance or Authority)
    - `status` 'missing' | 'under-review' | 'accepted'

## Other responses

- `201` — Integration Request successfully created
- `404` — Carrier not found
- `422` — Integration already requested

---

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