Skip to main content

List Branches

Get available branches for shipments.

All Branches​

GET /api/sucursales

Required permission: guias.read

Lists all visible branches in the system.

Response​

{
  "response": "OK",
  "data": [
    { "code": "GDLGL", "descripcion": "GUADALAJARA GONZALES GALLO" },
    { "code": "URU", "descripcion": "URUAPAN" },
    { "code": "MOR", "descripcion": "MORELIA" }
  ]
}

Destinations Only​

GET /api/sucursales/destinos

Required permission: guias.read

Lists only branches that can receive shipments. Use these codes in the DestinoCode field when creating guides.

Response​

{
  "response": "OK",
  "data": [
    { "code": "GDLGL", "descripcion": "GUADALAJARA GONZALES GALLO" },
    { "code": "MOR", "descripcion": "MORELIA" }
  ]
}

Origins Only​

GET /api/sucursales/origenes

Required permission: guias.read

Lists only branches that can send packages.

Response​

{
  "response": "OK",
  "data": [
    { "code": "URU", "descripcion": "URUAPAN" },
    { "code": "GDLGL", "descripcion": "GUADALAJARA GONZALES GALLO" }
  ]
}

cURL Example​

# Get valid destinations
curl -X GET "https://ws-api.masaprisaoperativo.com/api/sucursales/destinos" \
  -H "Authorization: Bearer {token}"
  1. At the start of your integration: Download the destinations list and cache it
  2. In your UI: Show a dropdown with available destinations
  3. Periodically: Refresh the list (branches may change)

:::info Note about Origin Your shipments' origin is determined by the branch assigned to your API user. You don't need to query or send it in requests. :::