[{"data":1,"prerenderedAt":7},["ShallowReactive",2],{"docs-entities\u002Fwarehouses\u002Fget":3,"docs-tabs-entities\u002Fwarehouses\u002Fget":6},{"content":4,"lastmod":5},"\n## Get a warehouse\n\n`GET \u002Fv1\u002Fwarehouses\u002F:id`\n\nReturns a single warehouse by identifier with all fields.\n\n## Path parameters\n\n| Parameter | Type | Description |\n|----------|-----|---------|\n| `id` | number | Warehouse identifier |\n\n## Examples\n\n### curl — personal key\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fwarehouses\u002F1\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth application\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fwarehouses\u002F1\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — personal key\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fwarehouses\u002F1', {\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n  },\n})\n\nconst { success, data } = await res.json()\nconsole.log(data.title)\n```\n\n### JavaScript — OAuth application\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.com\u002Fv1\u002Fwarehouses\u002F1', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\n\nconst { success, data } = await res.json()\n```\n\n## Response fields\n\n| Field | Type | Description |\n|------|-----|---------|\n| `success` | boolean | Always `true` on success |\n| `data` | object | Warehouse object — fields listed below |\n\n### Warehouse fields\n\n| Field | Type | Description |\n|------|-----|---------|\n| `id` | number | Warehouse identifier |\n| `title` | string | Warehouse name |\n| `address` | string | Warehouse address |\n| `active` | string | Active flag: `\"Y\"` \u002F `\"N\"` |\n| `issuingCenter` | string | Order pickup point flag: `\"Y\"` \u002F `\"N\"` |\n| `description` | string \\| null | Warehouse description. `null` if not set |\n| `phone` | string \\| null | Contact phone. `null` if not set |\n| `email` | string \\| null | Contact email. `null` if not set |\n| `schedule` | string \\| null | Working hours. `null` if not set |\n| `sort` | number | Sort order |\n| `code` | string \\| null | Symbolic code. `null` if not set |\n| `xmlId` | string \\| null | External identifier. `null` if not set |\n| `gpsN` | number \\| null | Geographic latitude. `null` if not set |\n| `gpsS` | number \\| null | Geographic longitude. `null` if not set |\n| `imageId` | object \\| null | Warehouse image: `{ \"id\", \"url\" }` or `null` |\n| `userId` | number \\| null | Responsible employee. `null` for system warehouses, populated when created via the API |\n| `modifiedBy` | number \\| null | Identifier of the user who last modified the warehouse. `null` for system warehouses, populated when created via the API |\n| `dateCreate` | datetime \\| null | Creation date. `null` for some system warehouses (for example, marketplaces) |\n| `dateModify` | datetime | Last modification date |\n\n## Response example\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 1,\n    \"title\": \"Main warehouse\",\n    \"address\": \"1 Harbour Street, Amsterdam\",\n    \"active\": \"Y\",\n    \"issuingCenter\": \"N\",\n    \"description\": \"Central warehouse\",\n    \"phone\": \"+12025550123\",\n    \"email\": \"warehouse@example.com\",\n    \"schedule\": \"Mon–Fri 9:00–20:00\",\n    \"sort\": 100,\n    \"code\": \"main\",\n    \"xmlId\": null,\n    \"gpsN\": 52.377956,\n    \"gpsS\": 4.897070,\n    \"imageId\": {\n      \"id\": 57,\n      \"url\": \"https:\u002F\u002Fcdn.bitrix24.com\u002Fb00000000\u002Fcatalog\u002Fstore.png\"\n    },\n    \"userId\": 1,\n    \"modifiedBy\": 1,\n    \"dateCreate\": \"2024-01-15T09:00:00+00:00\",\n    \"dateModify\": \"2024-06-20T14:30:00+00:00\"\n  }\n}\n```\n\n## Error response example\n\n404 — a warehouse with this `id` does not exist:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"ENTITY_NOT_FOUND\",\n    \"message\": \"store does not exist.\"\n  }\n}\n```\n\n## Errors\n\n| HTTP | Code | Description |\n|------|-----|---------|\n| 400 | `INVALID_PARAMS` | `id` is not a canonical positive integer: `12.5`, `12abc`, `1e2`, `007` are rejected before the Bitrix24 call |\n| 401 | `TOKEN_MISSING` | The API key has no configured tokens |\n| 403 | `SCOPE_DENIED` | The API key does not have the `catalog` scope |\n| 404 | `ENTITY_NOT_FOUND` | A warehouse with the specified `id` does not exist |\n\nThe full list of common API errors — [Errors](\u002Fdocs\u002Ferrors).\n\n## Known specifics\n\n**A nonexistent warehouse is `404`.** Requesting a warehouse by an unknown `id` returns `404` with code `ENTITY_NOT_FOUND`, the same as catalog products and prices. The `message` field still carries the Bitrix24 text `store does not exist.`.\n\n**Warehouse image.** The `imageId` field comes as an object `{ \"id\", \"url\" }` with a link to the warehouse image, or `null` if no image is set.\n\n## See also\n\n- [List warehouses](\u002Fdocs\u002Fentities\u002Fwarehouses\u002Flist)\n- [Update a warehouse](\u002Fdocs\u002Fentities\u002Fwarehouses\u002Fupdate)\n- [Warehouse stock](\u002Fdocs\u002Fentities\u002Fwarehouses\u002Fstock)\n- [API reference](\u002Fdocs\u002Fapi-reference)\n","2026-09-22",{},1794739443044]