---
title: Login
description: How to login to BxEngine API
---

[Skip to content](https://kb.bxsoftware.no/en/hjelp/login#main-content)

- [English](https://kb.bxsoftware.no/en/hjelp/login)
- [Norsk – Norge](https://kb.bxsoftware.no/hjelp/api-login)

English

Show submenu for translations

[![BxSoftware\_Logo\_Wordmark\_Color](https://kb.bxsoftware.no/hubfs/BxSoftware_Logo_Wordmark_Color.svg)](https://www.bxlogistics.no/)

- [Henvendelser](https://kb.bxsoftware.no/tickets)
- [Selvhjelp](https://kb.bxsoftware.no/hjelp)
- [Logg ut](https://kb.bxsoftware.no/_hcms/mem/logout)

Open main navigation

Close main navigation

- [Henvendelser](https://kb.bxsoftware.no/tickets)
- [Selvhjelp](https://kb.bxsoftware.no/hjelp)
- [Logg ut](https://kb.bxsoftware.no/_hcms/mem/logout)
- - [English](https://kb.bxsoftware.no/en/hjelp/login)
    - [Norsk – Norge](https://kb.bxsoftware.no/hjelp/api-login)

  English
  
  Show submenu for translations

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Selvhjelp](https://kb.bxsoftware.no/en/hjelp?hsLang=en)
2. [BxAPI](https://kb.bxsoftware.no/en/hjelp/bxapi?hsLang=en)

# Login

## How to login to BxEngine API

#### **Request**

### BaseUrl

```
https://api.bxsoftware.no/
```

### LoginURL

```
https://api.bxsoftware.no/1.0/Login
```

### HTTP Method

POST

### **HTTP Body**

```
{"username":"testuser","password":"123","companycode":123456}
```

 

### **Response Success**

### HTTP Code

200

### **Session info in http header**

set-cookie: BxSID=00000aaaaAAAA000000; expires=Tue, 14 Mar 2017 12:39:06 GMT; path=/; httponly

### Message in HTTP Body - User Info

```
{"success":true,"totalcount":1,"message":"","error":"","data":[{"userid":1,"username":"testuser","fullname":"Test User","accesslevel":"User","warehouse":"","erpuserid":0,"erpusername":"","employee":0,"profileid":1,"profilename":"Standard","companyname":"Standard","bxsid":"00000aaaaAAAA000000","companycode":"123456","companyid":1,"serverversion":"4.0.816.0","password":null,"serveripaddress":"123.123.123.123"}]}
```

 

#### **Response - Failure - CompanyCode not online or does not exist**

### HTTP Code

404

### HTTP Body

```
{"success":false,"totalcount":0,"message":"","error":"<Error><Code>404</Code><Detail>No service is hosted at the specified address. TrackingId:7618104a-836d-4986-b587-2478c075aa8e_G8, SystemTracker:bxsoft.servicebus.windows.net:1233333/1.0/Login, Timestamp:3/13/2017 12:51:08 PM</Detail></Error>","data":[]}
```

 

If the company id is correct, med 

```
{"success":false,"totalcount":0,"message":"","error":"Unauthorized","data":[]}
```

 

#### **Response - Failure - Invalid user/password for companycode**

### HTTP Code

401

### HTTP Body

```
{"success":false,"totalcount":0,"message":"","error":"Unauthorized","data":[]}
```

 

#### **Usage**

Get the BxSID from cookie or from the bxsid user json object. Notice that the data property is always an array for all our 1.0 and 2.0 rest services, when using /Login is will only contain one record.

All request to our rest api requires BxSID sent as a cookie parameter. eg:

```
GET 12182/1.0/products/ HTTP/1.1HOST:  api.bxsoftware.noCOOKIE: BxSID=00000aaaaAAAA000000
```

 

- [BxLogistics Installation](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installation?hsLang=en#main-content)

    - [BxEngine and BxSmartPrintPro](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installation?hsLang=en#bxengine-and-bxsmartprintpro)
    - [BxLogistics](https://kb.bxsoftware.no/en/hjelp/bxlogistics-installation?hsLang=en#bxlogistics)
- [ERP Integrations and setup](https://kb.bxsoftware.no/en/hjelp/erp-integrations-and-setup?hsLang=en#main-content)

    - [Visma Business](https://kb.bxsoftware.no/en/hjelp/erp-integrations-and-setup?hsLang=en#visma-business)
    - [VBNxt](https://kb.bxsoftware.no/en/hjelp/erp-integrations-and-setup?hsLang=en#vbnxt)
    - [Visma Net](https://kb.bxsoftware.no/en/hjelp/erp-integrations-and-setup?hsLang=en#visma-net)
    - [Xledger](https://kb.bxsoftware.no/en/hjelp/erp-integrations-and-setup?hsLang=en#xledger)
- [Transport integrations](https://kb.bxsoftware.no/en/hjelp/transport-integrations?hsLang=en#main-content)

    - [AxiaFrakt](https://kb.bxsoftware.no/en/hjelp/transport-integrations?hsLang=en#axiafrakt)
    - [Logistra Cargonizer](https://kb.bxsoftware.no/en/hjelp/transport-integrations?hsLang=en#logistra-cargonizer)
    - [ERP delivery methods](https://kb.bxsoftware.no/en/hjelp/transport-integrations?hsLang=en#erp-delivery-methods)
    - [nShift Shipment Server](https://kb.bxsoftware.no/en/hjelp/transport-integrations?hsLang=en#nshift-shipment-server)
    - [nShift/Unifaun Online](https://kb.bxsoftware.no/en/hjelp/transport-integrations?hsLang=en#nshift-unifaun-online)
    - [nShift/Consignor OnPrem](https://kb.bxsoftware.no/en/hjelp/transport-integrations?hsLang=en#nshift-consignor-onprem)
- [User guides BxMobile](https://kb.bxsoftware.no/en/hjelp/user-guides-bxmobile?hsLang=en#main-content)

    - [General](https://kb.bxsoftware.no/en/hjelp/user-guides-bxmobile?hsLang=en#general)
    - [Stock transfer](https://kb.bxsoftware.no/en/hjelp/user-guides-bxmobile?hsLang=en#stock-transfer)
    - [Products](https://kb.bxsoftware.no/en/hjelp/user-guides-bxmobile?hsLang=en#products)
    - [Picking](https://kb.bxsoftware.no/en/hjelp/user-guides-bxmobile?hsLang=en#picking)
    - [Stock count](https://kb.bxsoftware.no/en/hjelp/user-guides-bxmobile?hsLang=en#stock-count)
- [User Guides BxWebManager](https://kb.bxsoftware.no/en/hjelp/user-guides-bxwebmanager?hsLang=en#main-content)

    - [General](https://kb.bxsoftware.no/en/hjelp/user-guides-bxwebmanager?hsLang=en#general)
    - [Labels](https://kb.bxsoftware.no/en/hjelp/user-guides-bxwebmanager?hsLang=en#labels)
- [Technical Documentation](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#main-content)

    - [BxAdmin - Client UI](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#bxadmin-client-ui)
    - [BxSmartPrintPro](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#bxsmartprintpro)
    - [Picking - Freight booking](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#picking-freight-booking)
    - [Infrastructure](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#infrastructure)
    - [Visma Global specific](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#visma-global-specific)
    - [Visma Business specific](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#visma-business-specific)
    - [VismaNet specific](https://kb.bxsoftware.no/en/hjelp/technical-documentation?hsLang=en#vismanet-specific)
- [Stock count](https://kb.bxsoftware.no/en/hjelp/stock-count?hsLang=en#main-content)

    - [Visma Net](https://kb.bxsoftware.no/en/hjelp/stock-count?hsLang=en#visma-net)
- [Logistics](https://kb.bxsoftware.no/en/hjelp/logistics?hsLang=en#main-content)

    - [Location](https://kb.bxsoftware.no/en/hjelp/logistics?hsLang=en#location)
- [Troubleshooting](https://kb.bxsoftware.no/en/hjelp/troubleshooting?hsLang=en#main-content)

    - [Freight](https://kb.bxsoftware.no/en/hjelp/troubleshooting?hsLang=en#freight)
    - [Visma Net](https://kb.bxsoftware.no/en/hjelp/troubleshooting?hsLang=en#visma-net)
    - [BxMobile](https://kb.bxsoftware.no/en/hjelp/troubleshooting?hsLang=en#bxmobile)
    - [BxSmartPrintPro](https://kb.bxsoftware.no/en/hjelp/troubleshooting?hsLang=en#bxsmartprintpro)
    - [Visma Business](https://kb.bxsoftware.no/en/hjelp/troubleshooting?hsLang=en#visma-business)
    - [BxAdmin](https://kb.bxsoftware.no/en/hjelp/troubleshooting?hsLang=en#bxadmin)
- [BxAPI](https://kb.bxsoftware.no/en/hjelp/bxapi?hsLang=en)
- [Video archive](https://kb.bxsoftware.no/en/hjelp/video-archive?hsLang=en#main-content)

    - [Sales](https://kb.bxsoftware.no/en/hjelp/video-archive?hsLang=en#sales)
    - [Stock pick](https://kb.bxsoftware.no/en/hjelp/video-archive?hsLang=en#stock-pick)
    - [Stock count](https://kb.bxsoftware.no/en/hjelp/video-archive?hsLang=en#stock-count)
    - [General](https://kb.bxsoftware.no/en/hjelp/video-archive?hsLang=en#general)
    - [BxWebManager](https://kb.bxsoftware.no/en/hjelp/video-archive?hsLang=en#bxwebmanager)

[![BxSoftware\_Logo\_Symbol\_Color](https://kb.bxsoftware.no/hubfs/BxSoftware_Logo_Symbol_Color.svg "BxSoftware_Logo_Symbol_Color")](https://www.bxlogistics.no/)

Karihaugveien 89, Oslo, Norway

<https://www.linkedin.com/company/9465221/admin/dashboard/> <https://www.facebook.com/> [mailto:support@bxsoftware.no](mailto:support@bxsoftware.no)

Copyright © 2025, BxSoftware AS