> ## Documentation Index > Fetch the complete documentation index at: https://apidocs.returnhelper.com/llms.txt > Use this file to discover all available pages before exploring further. # アクセス可能な Warehouses をすべて取得 このページはAIによって自動翻訳されています。API技術仕様は英語が正式です。不明点がある場合は[英語版](/api-reference/warehouse/get-all-warehouses-accessible-to-user)を参照してください。 アカウントがアクセスできるすべての倉庫を、住所・連絡先・対応能力のメタデータと共に一覧表示します。多くの統合では、セットアップ時に一度呼び出して、倉庫を表示名へマッピングし、API 全体で必要となる `warehouseId` を取得します。 ご注意：本番環境とサンドボックス環境の `warehouseId` は **同一ではありません**。 ## 呼び出すタイミング * 統合のセットアップ時に、セラー向け UI の倉庫ピッカーを設定するため。 * アカウントが新しい倉庫へのアクセス権を付与された後（例：新地域の立ち上げ時）、ローカルキャッシュを更新するため。 ## レスポンスの注意 * `countryCode` は **小文字 ISO3**（例：`usa`、`gbr`、`chn`）で返されます。`shipFromCountry` や `fromCountryCode` などのフィールドにはこの値を使用してください。 * 完全な住所（`street1`、`street2`、`street3`、`city`、`state`、`postalCode`）が公開されているため、返品伝票や顧客向けラベルに宛先情報を事前入力できます。 * `description` は可読名称で、変更される可能性があります。データベース上の安定参照キーとしては `warehouseId`（整数）を使用してください。 ## 関連 * [発地国別の倉庫一覧](/ja/api-reference/warehouse/get-warehouses-by-origin-country) — 同じデータを発地国でフィルタしたもの。 * [ID で倉庫詳細を取得](/ja/api-reference/warehouse/get-warehouse-details-by-id-1) — `warehouseId` で 1 件の倉庫レコードを取得。 ## OpenAPI ````yaml get /api/Warehouse/GetAllWarehouse openapi: 3.1.0 info: title: Return Helper API description: API documentation for Return Helper — covering User and Public endpoints. version: 1.0.0 servers: - url: https://api.returnshelper.com/uat/user description: Sandbox — User API - url: https://api.returnshelper.com/uat/public description: Sandbox — Public API - url: https://api.returnhelpercentre.com/v1/user description: Production — User API - url: https://api.returnhelpercentre.com/v1/public description: Production — Public API - url: https://api.returnhelperchina.com/user description: Production — User API (China) security: - ApiKey: [] ApiToken: [] paths: /api/Warehouse/GetAllWarehouse: get: tags: - Warehouse summary: Get all warehouses accessible to user operationId: ReturnUserApi_GetAllWarehouse responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/GeneralList_WarehouseResponse' '401': description: >- Authentication failed. Returned when the `x-rr-apikey` or `x-rr-apitoken` header is missing or invalid. The body uses the standard `ApiResponse` envelope with `meta.error.message` describing the auth failure. content: application/json: schema: $ref: '#/components/schemas/ApiResponse' security: - ApiKey: [] ApiToken: [] servers: - url: https://api.returnshelper.com/uat/user description: Sandbox — User API components: schemas: GeneralList_WarehouseResponse: type: object properties: warehouses: type: array items: $ref: '#/components/schemas/WarehouseResponse' description: List of warehouses ApiResponse: type: object description: >- Universal response envelope. Successful responses include the business payload as additional top-level fields alongside `correlationId` and `meta`. Failed responses (auth errors, validation errors) only populate `correlationId` and `meta`, with `meta.errorCode` and `meta.error` describing the failure. properties: correlationId: type: - string - 'null' description: >- Unique correlation ID for tracing the request through Return Helper systems. meta: $ref: '#/components/schemas/ApiResponseMeta' WarehouseResponse: type: object properties: warehouseId: type: integer format: int32 description: Warehouse unique identifier countryCode: type: - string - 'null' description: Lowercase ISO3 country code (e.g. "usa") contactName: type: - string - 'null' description: Contact name companyName: type: - string - 'null' description: Company name phone: type: - string - 'null' description: Phone number email: type: - string - 'null' description: Email address fax: type: - string - 'null' description: Fax number street1: type: - string - 'null' description: Address line 1 street2: type: - string - 'null' description: Address line 2 street3: type: - string - 'null' description: Address line 3 state: type: - string - 'null' description: State / province city: type: - string - 'null' description: City postalCode: type: - string - 'null' description: Postal code addressType: type: - string - 'null' description: Address type description: type: - string - 'null' description: >- Free-text warehouse description. There is no separate warehouseName field — use warehouseId as the stable reference key. warehouseRmaPrefix: type: - string - 'null' description: Warehouse RMA prefix used in inbound parcel identifiers ApiResponseMeta: type: object description: >- Application-level metadata for every API response. Inspect `status` and `errorCode` to detect soft-error responses (validation failures arrive as HTTP 200 with `meta.status: 400`). properties: status: type: integer description: >- Application-level status code. For successful operations this mirrors the HTTP status (e.g. 200). For validation failures it reports the logical status (e.g. 400) even though the wire HTTP status is 200. data: type: object additionalProperties: type: string description: Reserved free-form metadata key/value pairs. Usually empty. errorCode: type: - string - 'null' description: >- Machine-readable error code (e.g. `VALIDATION_FAILED`). Non-null only when the operation failed. error: type: object additionalProperties: true description: >- Field-level or message-level error detail keyed by request property name. Empty object on success. securitySchemes: ApiKey: type: apiKey in: header name: x-rr-apikey description: Your API key ApiToken: type: apiKey in: header name: x-rr-apitoken description: Your API token — keep this private ````