Organización

Offices

Listado de offices. type distingue la sucursal de la bodega.

Requesthttp

GET /org-api/v1/offices

Permiso: organization:read, packages:read o packages:write. Una sola ruta devuelve sucursales y bodegas. type dice cuál es: office atiende al cliente y su id se usa como locationId; warehouse es bodega y su id se usa como warehouseId. Sin query vienen los dos. ?type=office o ?type=warehouse filtra. No hay paginación. En el SDK es traky.offices.list() y traky.offices.list({ type: "warehouse" }).

Ejemplobash

curl -sS -H "Authorization: Bearer TU_API_KEY" \
  "{BASE_URL}/org-api/v1/offices?type=warehouse"

Envoltorio

Atributo	Tipo	Descripción
data	array	Offices de la empresa. Vacío si no hay ninguno.

Query

Atributo	Tipo	Descripción
type	string	Opcional. office o warehouse. Sin filtro devuelve los dos.

Atributos

Los textos de dirección pueden venir vacíos. pricePerPoundClient y pricePerPoundProvider solo vienen si type es warehouse. La respuesta no incluye el mapa de racks, las tarifas por servicio ni las restricciones del panel.

Atributo	Tipo	Descripción
id	string	UUID. Sucursal: locationId. Bodega: warehouseId.
type	string	office atiende al cliente. warehouse es bodega. Sirve para sumar otro tipo.
name	string \| null	Nombre visible. Null si no tiene.
isActive	boolean	True si está activa.
isMain	boolean	True si es la principal. En una bodega es false.
countryCode	string	País ISO, por ejemplo EC o US.
stateOrProvince	string	Provincia o estado.
stateCode	string	Código de la provincia o del estado.
city	string	Ciudad.
cityCode	string	Código de la ciudad, por ejemplo GYE.
address	string	Dirección.
suiteOrApt	string	Oficina, local o apartamento.
postalCode	string	Código postal.
phoneNumber	string	Teléfono.
fax	string	Fax.
note	string	Nota interna.
createdAt	string \| null	Fecha de creación, ISO 8601.
updatedAt	string \| null	Fecha de la última actualización, ISO 8601.
pricePerPoundClient	number	Precio por libra al cliente. Solo si type es warehouse. Sin precio, 0.
pricePerPoundProvider	number	Precio por libra al proveedor. Solo si type es warehouse. Sin precio, 0.

JSON de retorno

jsonjson

{
  "data": [
    {
      "id": "6a1d0c44-8b22-4f90-a113-9e2c4d6b88a1",
      "name": "Guayaquil",
      "type": "office",
      "isActive": true,
      "isMain": true,
      "countryCode": "EC",
      "stateOrProvince": "Guayas",
      "stateCode": "G",
      "city": "Guayaquil",
      "cityCode": "GYE",
      "address": "Av. 9 de Octubre 100",
      "suiteOrApt": "",
      "postalCode": "090101",
      "phoneNumber": "+59340000000",
      "fax": "",
      "note": "",
      "createdAt": "2026-10-20T15:04:00.000Z",
      "updatedAt": "2026-10-24T12:10:00.000Z"
    },
    {
      "id": "b7e2c910-33aa-4d18-8f44-1c0a9e6d55b2",
      "name": "Miami",
      "type": "warehouse",
      "isActive": true,
      "isMain": false,
      "countryCode": "US",
      "stateOrProvince": "Florida",
      "stateCode": "FL",
      "city": "Miami",
      "cityCode": "MIA",
      "address": "NW 25th St 100",
      "postalCode": "33142",
      "pricePerPoundClient": 2.5,
      "pricePerPoundProvider": 1.5,
      "createdAt": "2026-10-20T15:04:00.000Z",
      "updatedAt": "2026-10-24T12:10:00.000Z"
    }
  ]
}

Envoltorio

Query

Atributos

JSON de retorno

Buscar en la documentación