Organizaciones

Endpoints

Obtener mi organización

get

Retorna los datos de la organización autenticada (la que corresponde al token Bearer utilizado).

Autorizaciones

orgToken

AuthorizationstringRequerido

Token Bearer generado en la sección de integraciones de tu organización en Zipnova Rutas.

Respuestas

200

Datos de la organización

application/json

401

No autenticado

403

Sin permisos

get/organizations/my

HTTPcURLJavaScriptPython

GET /api/v1/organizations/my HTTP/1.1
Host: mi-organizacion.routes.zipnova.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "organization": {
    "id": "org_01GQBRNWN8ZS4X8K9WN5DFXH3Y",
    "name": "Transporte Rex SA",
    "subdomain": "transporte-rex",
    "custom_domain": "app.transporte-rex.com",
    "locale": "es",
    "timezone": "America/Argentina/Buenos_Aires",
    "currency": "ARS",
    "suspended_at": "2026-07-11T16:58:39.765Z",
    "operational_address_id": "ple_01J9X2K3M4N5P6Q7R8S9T0V1W2"
  }
}

Listar lugares de la organización

get

Retorna todos los lugares operativos (depósitos, sucursales, puntos de retiro) guardados en la organización.

Autorizaciones

orgToken

AuthorizationstringRequerido

Token Bearer generado en la sección de integraciones de tu organización en Zipnova Rutas.

Respuestas

200

Lista de lugares

application/json

401

No autenticado

403

Sin permisos

get/organizations/my/places

HTTPcURLJavaScriptPython

GET /api/v1/organizations/my/places HTTP/1.1
Host: mi-organizacion.routes.zipnova.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "places": [
    {
      "id": "ple_01J9X2K3M4N5P6Q7R8S9T0V1W2",
      "org_id": 42,
      "name": "Depósito Central",
      "street": "Av. Corrientes",
      "street_number": "1234",
      "floor": "3",
      "apartment": "A",
      "reference": "Edificio azul, portón azul",
      "phone_raw": "1134567890",
      "phone": "[phone]",
      "email": "[e-mail]",
      "zipcode": "C1043",
      "city": {
        "id": 1024,
        "name": "Buenos Aires"
      },
      "state": {
        "code": "AR-B",
        "name": "Buenos Aires"
      },
      "country": {
        "code": "AR",
        "name": "Argentina"
      }
    }
  ]
}

Listar contratos de la organización

get

Retorna las organizaciones con las que existe un contrato activo. Permite filtrar por tipo de licencia (shipper o carrier), ordenar y paginar resultados.

Autorizaciones

orgToken

AuthorizationstringRequerido

Token Bearer generado en la sección de integraciones de tu organización en Zipnova Rutas.

Parámetros de consulta

licensestring · enumOpcional

Tipo de licencia: shipper (remitentes con los que opero como carrier) o carrier (transportistas que me atienden como shipper). Por defecto: shipper.

Example: shipperValores posibles:

filter[global]stringOpcional

Búsqueda por nombre de organización o mercado.

sortstring · enumOpcional

Campo de ordenamiento. Prefijo - para descendente.

Valores posibles:

perPageintegerOpcional

Cantidad de resultados por página.

Default: 10Example: 20

Respuestas

200

Lista paginada de organizaciones con contrato

application/json

401

No autenticado

403

Sin permisos

get/organizations/my/contracts

HTTPcURLJavaScriptPython

GET /api/v1/organizations/my/contracts HTTP/1.1
Host: mi-organizacion.routes.zipnova.app
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "organizations": {
    "data": [
      {
        "id": "org_01GQBRNWN8ZS4X8K9WN5DFXH3Y",
        "name": "Transporte Rex SA",
        "subdomain": "transporte-rex",
        "custom_domain": "app.transporte-rex.com",
        "locale": "es",
        "timezone": "America/Argentina/Buenos_Aires",
        "currency": "ARS",
        "suspended_at": "2026-07-11T16:58:39.765Z",
        "operational_address_id": "ple_01J9X2K3M4N5P6Q7R8S9T0V1W2"
      }
    ],
    "links": {
      "first": "https://example.com",
      "last": "https://example.com",
      "prev": "https://example.com",
      "next": "https://example.com"
    },
    "meta": {
      "total": 150,
      "per_page": 20,
      "current_page": 1,
      "last_page": 8,
      "from": 1,
      "to": 20
    }
  }
}

Modelos