# Locations _(Realtime-enabled)_

`GET` `POST` `PATCH` `DELETE` _(Table: Location)_

```
eOne/core/v1.0/locations
```

Read and write warehouses with their address, contact details and warehouse-handling flags. The `code` is the primary key; PATCHing it renames the location.

Warehouse [bins](https://eonesolutions.github.io/eone-bc-integration/core-bins.md) hang off each location as a nested sub-page. `$expand=bins` to read them inline, or deep-insert them when you create the location.

> **Caution:** PATCHing `code` **renames** the location (carrying its history) rather than creating a new one.

## Locations fields

_API column → BC field._

**Legend**

- _(req)_ required on create
- _(res)_ resolver
- _(cur)_ currency-translated
- _(ro)_ read-only
- _(ext)_ added to this endpoint by another extension (BC field name shown; its API column name is not known here)

| API | BC field | Notes |
| --- | --- | --- |
| `id` | SystemId | BC record GUID. _(ro)_ |
| `bcCompanyId` | bcCompanyId | The company this row belongs to - the same GUID that appears in the request URL. Present on every endpoint so a store pooling several companies can keep them apart without relying on which URL it called. _(ro)_ |
| `bcCompanyName` | bcCompanyName | The name of the company this row belongs to. _(ro)_ |
| `code` | Code | Primary key. PATCH renames. _(req)_ |
| `integrationId` | EONE Integration Id | Your external key. |
| `displayName` | Name | Location name. |
| `name2` | Name 2 | Second name line. |
| `address` | Address |  |
| `address2` | Address 2 |  |
| `city` | City |  |
| `county` | County | State / county. |
| `postCode` | Post Code |  |
| `countryRegionCode` | Country/Region Code |  |
| `phoneNumber` | Phone No. |  |
| `email` | E-Mail |  |
| `homePage` | Home Page | Website. |
| `contact` | Contact | Contact person name. |
| `useAsInTransit` | Use As In-Transit | Marks an in-transit location for transfers. |
| `binMandatory` | Bin Mandatory | Bin-level handling on. |
| `requirePutaway` | Require Put-away |  |
| `requirePick` | Require Pick |  |
| `requireReceive` | Require Receive |  |
| `requireShipment` | Require Shipment |  |
| `directedPutawayAndPick` | Directed Put-away and Pick | Advanced warehouse mode. |
| `createdDateTime` | SystemCreatedAt | _(ro)_ |
| `lastModifiedDateTime` | SystemModifiedAt | _(ro)_ |

## Related pages

Collections nested under this endpoint:

- [Bins](https://eonesolutions.github.io/eone-bc-integration/core-bins.md)