# Get Warehouse List

Get Warehouses — Retrieve all warehouses for the authenticated store; returns a list in the standard response envelope.

Overview

HMAC

At a glance

Contains warehouses.

Auth: HMAC Partner
Method: GET

# Path

https://partners-api.tocobagus.net/api/v1 /partner/stores/warehouses

# Request

Query parameters: None.

# Required Headers

Header	Example	Description
`x-signature`	bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80	HMAC signature of the request, computed with the partner secret and `x-timestamp` (auth integrity).
`x-partner-client-id`	2025112012475048491498	Partner identifier issued by Omni; used to locate the partner secret.
`x-store-client-id`	638765489981529612855	Target store identifier under the partner account.
`x-store-token`	stkn__6AbJF05mjvxh7sh	Store access token for store-level authorization.
`x-timestamp`	1758100350458	UNIX epoch timestamp used when computing `x-signature` (replay protection).

# Request Payload

Request payload: Not used for GET.

# Example Request

Curl Node.js Go Java

curl -X GET "http:///partner/stores/warehouses" \
  -H "Content-Type: application/json" \
  -H "x-signature: bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80" \
  -H "x-partner-client-id: 2025112012475048491498" \
  -H "x-store-client-id: 638765489981529612855" \
  -H "x-store-token: stkn__6AbJF05mjvxh7sh" \
  -H "x-timestamp: 1758100350458" \

const qs = new URLSearchParams({});
const url = "http:///partner/stores/warehouses" + (qs.toString() ? "?" + qs.toString() : "");
const res = await fetch(url, {
  method: "GET",
  headers: {
  "x-signature": "bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80",
  "x-partner-client-id": "2025112012475048491498",
  "x-store-client-id": "638765489981529612855",
  "x-store-token": "stkn__6AbJF05mjvxh7sh",
  "x-timestamp": "1758100350458"
}
});
const json = await res.json();
console.log(json);

qs := url.Values{}

u := "http:///partner/stores/warehouses"
if q := qs.Encode(); q != "" { u = u + "?" + q }
req, _ := http.NewRequest("GET", u, nil)
req.Header.Set("x-signature", "bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80")
req.Header.Set("x-partner-client-id", "2025112012475048491498")
req.Header.Set("x-store-client-id", "638765489981529612855")
req.Header.Set("x-store-token", "stkn__6AbJF05mjvxh7sh")
req.Header.Set("x-timestamp", "1758100350458")
req.Header.Set("Content-Type","application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
b, _ := io.ReadAll(resp.Body)
fmt.Println(string(b))

var client = java.net.http.HttpClient.newHttpClient();
var req = java.net.http.HttpRequest.newBuilder()
    .uri(java.net.URI.create("http:///partner/stores/warehouses"))
    .header("Content-Type","application/json")
    .header("x-signature", "bdbb8833fe43671e058b56dace75763a78a2edf8de7365afb6f534d750056e80")
    .header("x-partner-client-id", "2025112012475048491498")
    .header("x-store-client-id", "638765489981529612855")
    .header("x-store-token", "stkn__6AbJF05mjvxh7sh")
    .header("x-timestamp", "1758100350458")
    .method("GET", java.net.http.HttpRequest.BodyPublishers.noBody())
    .build();
var res = client.send(req, java.net.http.HttpResponse.BodyHandlers.ofString());
System.out.println(res.body());

# Responses

# Example Responses

200 OK

{
  "success": true,
  "message": "Warehouses retrieved successfully",
  "requestId": "f86e9523-b970-4fb8-b3ba-61dc146f408b",
  "meta": {
    "timestamp": "2026-02-04T21:35:48.479Z"
  },
  "data": [
    {
      "id": "625d5773-6bb7-4ef8-8692-e44191dc53a7",
      "externalId": "070f7572-1ad6-4dcb-bf33-52ca6ecfbf46",
      "clientId": "2026012714314318226016",
      "phone": "6282189053385",
      "area": {
        "provinceId": "b229c881-1e64-4f4a-a0e6-046619077275",
        "cityId": "563653c4-34cf-442b-b91b-426abf9a27da",
        "districtId": "b7c49d64-291e-4fac-ac96-c416317ac405",
        "subDistrictId": "16b88274-73cf-4629-9046-0e1c0d78654a",
        "latitude": "-6.3174233",
        "longitude": "106.649099",
        "postalCode": "15345",
        "address": "Icon Ruko"
      },
      "warehouseName": "Warehouse Utama",
      "syncStatus": "synced",
      "isMain": true,
      "createdAt": "2026-01-27T14:31:44.064Z"
    },
    {
      "id": "fe4b5387-7517-45e1-8d8f-a91e9384fca4",
      "externalId": "21104dfe-7395-4c82-9a40-bb8ac209d515",
      "clientId": "2026020421142429234025",
      "phone": "+6281212121212",
      "area": {
        "provinceId": "b229c881-1e64-4f4a-a0e6-046619077275",
        "cityId": "563653c4-34cf-442b-b91b-426abf9a27da",
        "districtId": "b7c49d64-291e-4fac-ac96-c416317ac405",
        "subDistrictId": "948e7af9-576a-4aa8-927e-36cd441f673e",
        "latitude": "-6.3173721",
        "longitude": "106.6485749",
        "postalCode": "15344",
        "address": "Jl.cisauk 211"
      },
      "warehouseName": "Cabang Sampora 2",
      "syncStatus": "synced",
      "isMain": false,
      "createdAt": "2026-02-04T21:14:24.838Z"
    },
    {
      "id": "dfc5a3b2-c07f-4f45-b977-782fff8ee0a5",
      "externalId": "5c4beef9-da5d-4d80-8638-4377e1927da6",
      "clientId": "2026020420585423124945",
      "phone": "+6281212121212",
      "area": {
        "provinceId": "b229c881-1e64-4f4a-a0e6-046619077275",
        "cityId": "563653c4-34cf-442b-b91b-426abf9a27da",
        "districtId": "b7c49d64-291e-4fac-ac96-c416317ac405",
        "subDistrictId": "948e7af9-576a-4aa8-927e-36cd441f673e",
        "latitude": "-6.3173721",
        "longitude": "106.6485749",
        "postalCode": "15344",
        "address": "Jl.cisauk 211"
      },
      "warehouseName": "Cabang Sampora",
      "syncStatus": "synced",
      "isMain": false,
      "createdAt": "2026-02-04T20:58:54.916Z"
    }
  ]
}

401 Unauthorized

{
  "success": false,
  "error": {
    "code": "AUTH_011",
    "message": "Partner ID not registered",
    "details": {
      "timestamp": "2026-02-04T21:32:40.994Z",
      "hint": "Partner not found",
      "context": {
        "partnerClientId": "ptnr_1s4UqMnO64"
      }
    }
  },
  "requestId": "5254e2cb-57ca-4778-975d-6423b62dcf2a"
}

# Dictionary

None for this endpoint.

# Notes

None for this endpoint.