Companies

Manage company records including customers, vendors, carriers, and franchisees. Companies are the core entities in the system that can place orders, provide services, or act as shipping partners.

Quick Reference

Method

Endpoint

Description

GET

/api/companies/{id}

Get company by ID

GET

/api/companies/{companyId}/details

Get company details

GET

/api/companies/availableByCurrentUser

Get companies available to current user

GET

/api/companies/search

Search companies

POST

/api/companies/search/v2

Advanced company search

POST

/api/companies/list

POST

/api/companies/simplelist

GET

/api/companies/{companyId}/fulldetails

Get complete company information

PUT

/api/companies/{companyId}/fulldetails

Update complete company information

POST

/api/companies/fulldetails

GET

/api/companies/infoFromKey

GET

/api/companies/{companyId}/geosettings

POST

/api/companies/{companyId}/geosettings

GET

/api/companies/geosettings

POST

/api/companies/filteredCustomers

GET

/api/companies/{companyId}/carrierAcounts

POST

/api/companies/{companyId}/carrierAcounts

GET

/api/companies/{companyId}/capabilities

POST

/api/companies/{companyId}/capabilities

GET

/api/companies/{companyId}/packagingsettings

POST

/api/companies/{companyId}/packagingsettings

GET

/api/companies/{companyId}/inheritedPackagingTariffs

GET

/api/companies/{companyId}/packaginglabor

POST

/api/companies/{companyId}/packaginglabor

GET

/api/companies/{companyId}/inheritedpackaginglabor

GET

/api/companies/geoAreaCompanies

GET

/api/companies/brands

GET

/api/companies/brandstree

GET

/api/companies/{companyId}/franchiseeAddresses

GET /api/companies/{id}

Get company by ID

Retrieves detailed information about a specific company using its unique identifier.

Parameters:

Path Parameters:

  • id (string, path) (required): No description available

Response Type:

CompanyBasic

See the model documentation for detailed field descriptions.

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/{id}"
,
    id="789e0123-e89b-12d3-a456-426614174002"

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "ed282b80-54fe-4f42-bf1b-69103ce1f76c",
3  "code": "TRAINING",
4  "name": "Training",
5  "parentCompanyId": "5e2eefc1-d616-e911-b00c-00155d426802"
6}

GET /api/companies/{companyId}/details

Get company details

Retrieves comprehensive details about a company including contacts, addresses, settings, and financial information.

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Response Type:

CompanyDetails

See the model documentation for detailed field descriptions.

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/{companyId}/details"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"

)

# Process the response
print(response)

Sample Response:

 1{
 2  "companyID": "ed282b80-54fe-4f42-bf1b-69103ce1f76c",
 3  "companyName": "Training",
 4  "companyCode": "TRAINING",
 5  "companyEmail": "training@abconnect.co",
 6  "companyPhone": "8009814202",
 7  "mainAddress": {
 8    "id": 407491,
 9    "address1": "2534 Vista Dr",
10    "city": "Castle Rock",
11    "state": "CO",
12    "zipCode": "80104",
13    "latitude": 39.2942344,
14    "longitude": -104.8221147
15  },
16  "companyInfo": {
17    "companyId": "ed282b80-54fe-4f42-bf1b-69103ce1f76c",
18    "companyName": "Training",
19    "companyCode": "TRAINING",
20    "isThirdParty": false,
21    "isActive": true
22  }
23}

GET /api/companies/availableByCurrentUser

Get companies available to current user

Returns a list of companies that the currently authenticated user has permission to access.

Response Type:

Array of CompanyBasic objects

See the model documentation for detailed field descriptions.

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/availableByCurrentUser"

)

# Process the response
print(response)

Sample Response:

1[
2  {
3    "id": "ed282b80-54fe-4f42-bf1b-69103ce1f76c",
4    "code": "TRAINING",
5    "name": "Training",
6    "parentCompanyId": "5e2eefc1-d616-e911-b00c-00155d426802"
7  }
8]

POST /api/companies/search/v2

Advanced company search

Perform advanced searches on companies with complex filtering, sorting, and pagination options.

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.post(
    "/api/companies/search/v2"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1[]

POST /api/companies/list

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.post(
    "/api/companies/list"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "789e0123-e89b-12d3-a456-426614174002",
3  "status": "created",
4  "message": "Resource created successfully"
5}

POST /api/companies/simplelist

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.post(
    "/api/companies/simplelist"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "789e0123-e89b-12d3-a456-426614174002",
3  "status": "created",
4  "message": "Resource created successfully"
5}

GET /api/companies/{companyId}/fulldetails

Get complete company information

Retrieves all available information about a company including details, preferences, capabilities, pricing, and insurance settings.

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Response Type:

CompanyFullDetails

See the model documentation for detailed field descriptions.

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/{companyId}/fulldetails"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"

)

# Process the response
print(response)

Sample Response:

 1{
 2  "id": "ed282b80-54fe-4f42-bf1b-69103ce1f76c",
 3  "details": {
 4    "displayId": "694618",
 5    "name": "Training",
 6    "code": "TRAINING",
 7    "parentId": "5e2eefc1-d616-e911-b00c-00155d426802",
 8    "companyTypeId": "e7f85166-34cf-429b-805d-261b44cb0c04",
 9    "phone": "8009814202",
10    "email": "training@abconnect.co",
11    "isActive": true
12  },
13  "preferences": {
14    "isQbUser": false,
15    "skipIntacct": true,
16    "pzCode": "PZ100"
17  },
18  "capabilities": 135,
19  "address": {
20    "id": 407491,
21    "address1": "2534 Vista Dr",
22    "city": "Castle Rock",
23    "state": "CO",
24    "zipCode": "80104"
25  },
26  "pricing": {
27    "transportationCharge": {
28      "baseTripFee": 100.0,
29      "baseTripMile": 3000.0
30    },
31    "transportationMarkups": {
32      "wholeSale": 1.0,
33      "base": 1.25,
34      "medium": 2.3,
35      "high": 2.5
36    }
37  }
38}

PUT /api/companies/{companyId}/fulldetails

Update complete company information

Updates all company information including details, preferences, capabilities, pricing, and insurance settings.

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.put(
    "/api/companies/{companyId}/fulldetails"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1{}

POST /api/companies/fulldetails

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.post(
    "/api/companies/fulldetails"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1{}

GET /api/companies/infoFromKey

Parameters:

Query Parameters:

  • key (string, query): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/infoFromKey"

)

# Process the response
print(response)

Sample Response:

1{
2  "status": "success",
3  "data": {}
4}

GET /api/companies/{companyId}/geosettings

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/{companyId}/geosettings"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "ed282b80-54fe-4f42-bf1b-69103ce1f76c",
3  "code": "TRAINING",
4  "name": "Training",
5  "parentCompanyId": "5e2eefc1-d616-e911-b00c-00155d426802"
6}

POST /api/companies/{companyId}/geosettings

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.post(
    "/api/companies/{companyId}/geosettings"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "789e0123-e89b-12d3-a456-426614174002",
3  "status": "created",
4  "message": "Resource created successfully"
5}

GET /api/companies/geosettings

Parameters:

Query Parameters:

  • Latitude (number, query): No description available

  • Longitude (number, query): No description available

  • milesRadius (integer, query): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/geosettings"

)

# Process the response
print(response)

Sample Response:

1[]

POST /api/companies/filteredCustomers

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.post(
    "/api/companies/filteredCustomers"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "789e0123-e89b-12d3-a456-426614174002",
3  "status": "created",
4  "message": "Resource created successfully"
5}

GET /api/companies/{companyId}/carrierAcounts

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/{companyId}/carrierAcounts"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "ed282b80-54fe-4f42-bf1b-69103ce1f76c",
3  "code": "TRAINING",
4  "name": "Training",
5  "parentCompanyId": "5e2eefc1-d616-e911-b00c-00155d426802"
6}

POST /api/companies/{companyId}/carrierAcounts

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.post(
    "/api/companies/{companyId}/carrierAcounts"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "789e0123-e89b-12d3-a456-426614174002",
3  "status": "created",
4  "message": "Resource created successfully"
5}

GET /api/companies/{companyId}/capabilities

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/{companyId}/capabilities"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "ed282b80-54fe-4f42-bf1b-69103ce1f76c",
3  "code": "TRAINING",
4  "name": "Training",
5  "parentCompanyId": "5e2eefc1-d616-e911-b00c-00155d426802"
6}

POST /api/companies/{companyId}/capabilities

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.post(
    "/api/companies/{companyId}/capabilities"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "789e0123-e89b-12d3-a456-426614174002",
3  "status": "created",
4  "message": "Resource created successfully"
5}

GET /api/companies/{companyId}/packagingsettings

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/{companyId}/packagingsettings"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "ed282b80-54fe-4f42-bf1b-69103ce1f76c",
3  "code": "TRAINING",
4  "name": "Training",
5  "parentCompanyId": "5e2eefc1-d616-e911-b00c-00155d426802"
6}

POST /api/companies/{companyId}/packagingsettings

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.post(
    "/api/companies/{companyId}/packagingsettings"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "789e0123-e89b-12d3-a456-426614174002",
3  "status": "created",
4  "message": "Resource created successfully"
5}

GET /api/companies/{companyId}/inheritedPackagingTariffs

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Query Parameters:

  • inheritFrom (string, query): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/{companyId}/inheritedPackagingTariffs"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "ed282b80-54fe-4f42-bf1b-69103ce1f76c",
3  "code": "TRAINING",
4  "name": "Training",
5  "parentCompanyId": "5e2eefc1-d616-e911-b00c-00155d426802"
6}

GET /api/companies/{companyId}/packaginglabor

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/{companyId}/packaginglabor"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "ed282b80-54fe-4f42-bf1b-69103ce1f76c",
3  "code": "TRAINING",
4  "name": "Training",
5  "parentCompanyId": "5e2eefc1-d616-e911-b00c-00155d426802"
6}

POST /api/companies/{companyId}/packaginglabor

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.post(
    "/api/companies/{companyId}/packaginglabor"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"
,
    data=
    {
        "example": "data"
}

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "789e0123-e89b-12d3-a456-426614174002",
3  "status": "created",
4  "message": "Resource created successfully"
5}

GET /api/companies/{companyId}/inheritedpackaginglabor

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Query Parameters:

  • inheritFrom (string, query): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/{companyId}/inheritedpackaginglabor"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "ed282b80-54fe-4f42-bf1b-69103ce1f76c",
3  "code": "TRAINING",
4  "name": "Training",
5  "parentCompanyId": "5e2eefc1-d616-e911-b00c-00155d426802"
6}

GET /api/companies/geoAreaCompanies

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/geoAreaCompanies"

)

# Process the response
print(response)

Sample Response:

1[]

GET /api/companies/brands

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/brands"

)

# Process the response
print(response)

Sample Response:

1[]

GET /api/companies/brandstree

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/brandstree"

)

# Process the response
print(response)

Sample Response:

1{
2  "status": "success",
3  "data": {}
4}

GET /api/companies/{companyId}/franchiseeAddresses

Parameters:

Path Parameters:

  • companyId (string, path) (required): No description available

Example Request:

from ABConnect import ABConnectAPI

# Initialize the API client
api = ABConnectAPI()

# Make the API call
response = api.raw.get(
    "/api/companies/{companyId}/franchiseeAddresses"
,
    companyId="ed282b80-54fe-4f42-bf1b-69103ce1f76c"

)

# Process the response
print(response)

Sample Response:

1{
2  "id": "ed282b80-54fe-4f42-bf1b-69103ce1f76c",
3  "code": "TRAINING",
4  "name": "Training",
5  "parentCompanyId": "5e2eefc1-d616-e911-b00c-00155d426802"
6}