Query master guides by client and date range

Returns a paginated list of master guides associated with a client, filtered by date range.

GET /mawb/clients/{identification}/guides v1.0.0
Autenticación
Bearer Token
Ambiente
Development Server (DEV), Test Server, Production Server

Descripción

Returns a paginated list of master guides associated with a client, filtered by date range.

The maximum range between start_date and end_date is 6 months.

Rate limiting: 10 requests per minute per client.

Can be queried at any time after creating master guides with POST /mawb.

🔐 Authentication required

HeaderAuthorization: Bearer <access_token>
Token (TEST)POST https://api-test.coordinadora.tech/oauth/token
Token (PROD)POST https://api.coordinadora.tech/oauth/token
MethodBasic Auth — Client ID as username, Client Secret as password
BodyContent-Type: application/x-www-form-urlencoded · grant_type=client_credentials
Validity3600 seconds
HTTP 401Token not sent, invalid or expired

Credentials (Client ID and Client Secret) are provided by Coordinadora's Technology Department.

Quick Start

  1. Obtén tus credenciales de acceso (Bearer Token).
  2. Selecciona el ambiente y completa los parámetros requeridos.
  3. Envía la solicitud y procesa la respuesta.

Ejemplo rápido

Generando ejemplo…

Endpoint

GET /mawb/clients/{identification}/guides

Base URL https://api-dev.coordinadora.tech/nacionalizacion

Parámetros

Nombre Tipo Requerido Descripción
identification path string Sí Client NIT (tax ID) registered at Coordinadora. Used to filter master guides associated with that client.
start_date query string Sí Start date of the query range in ISO format (YYYY-MM-DD). Required.
end_date query string Sí End date of the query range in ISO format (YYYY-MM-DD). Must be greater than or equal to start_date. Maximum range: 6 months. Required.
page query integer No Page number to query. Minimum: 1. Default: 1.
limit query integer No Number of records per page. Minimum: 1, Maximum: 100. Default: 10.

Respuesta

200
Paginated list of master guides retrieved successfully.
{
    "isError": false,
    "data": {
        "data": [
            {
                "mawb": "406024230831",
                "creation_date": "2026-03-12T10:00:00.000Z",
                "status_name": "In transit",
                "arrival_airport": "BOG",
                "departure_airport": "PEK",
                "destination_city": "BOGOTA",
                "departure_city": "PEKIN",
                "sender_city": "PEKIN",
                "consignee_department": "CUNDINAMARCA",
                "destination_department": "CUNDINAMARCA",
                "consignee_address": "Carrera 7 # 32-16",
                "sender_address": "Calle Comercio 45",
                "airline_verification_digit": "6",
                "consignee_verification_digit": "1",
                "status_date": "2026-03-14T08:30:00.000Z",
                "eta": "2026-03-14T16:30:00.000Z",
                "etd": "2026-03-12T10:15:00.000Z",
                "destination_date": "2026-03-15T08:00:00.000Z",
                "arrival_date": "2026-03-14T17:00:00.000Z",
                "associated_guides": 23,
                "enable_nationalization": true,
                "airline_nit": "800249687",
                "consignee_nit": "900123456",
                "sender_nit": "987654321",
                "airline_name": "LATAM AIRLINES COLOMBIA",
                "consignee_name": "Comercio Internacional SAS",
                "sender_name": "Proveedor Internacional S.A.",
                "flight_number": "LA9999",
                "destination_country": "Colombia",
                "departure_country": "China",
                "associated_guides_weight": 98.5,
                "weight_kg": 112,
                "sender_phone": "861012345678",
                "cargo_type": "1",
                "declared_value_usd": 5000,
                "exchange_rate": 4200
            }
        ],
        "total_records": 1,
        "total_pages": 1,
        "current_page": 1
    }
}

Ejemplo de respuesta

200 Paginated list of master guides retrieved successfully. 
{
    "isError": false,
    "data": {
        "data": [
            {
                "mawb": "406024230831",
                "creation_date": "2026-03-12T10:00:00.000Z",
                "status_name": "In transit",
                "arrival_airport": "BOG",
                "departure_airport": "PEK",
                "destination_city": "BOGOTA",
                "departure_city": "PEKIN",
                "sender_city": "PEKIN",
                "consignee_department": "CUNDINAMARCA",
                "destination_department": "CUNDINAMARCA",
                "consignee_address": "Carrera 7 # 32-16",
                "sender_address": "Calle Comercio 45",
                "airline_verification_digit": "6",
                "consignee_verification_digit": "1",
                "status_date": "2026-03-14T08:30:00.000Z",
                "eta": "2026-03-14T16:30:00.000Z",
                "etd": "2026-03-12T10:15:00.000Z",
                "destination_date": "2026-03-15T08:00:00.000Z",
                "arrival_date": "2026-03-14T17:00:00.000Z",
                "associated_guides": 23,
                "enable_nationalization": true,
                "airline_nit": "800249687",
                "consignee_nit": "900123456",
                "sender_nit": "987654321",
                "airline_name": "LATAM AIRLINES COLOMBIA",
                "consignee_name": "Comercio Internacional SAS",
                "sender_name": "Proveedor Internacional S.A.",
                "flight_number": "LA9999",
                "destination_country": "Colombia",
                "departure_country": "China",
                "associated_guides_weight": 98.5,
                "weight_kg": 112,
                "sender_phone": "861012345678",
                "cargo_type": "1",
                "declared_value_usd": 5000,
                "exchange_rate": 4200
            }
        ],
        "total_records": 1,
        "total_pages": 1,
        "current_page": 1
    }
}

Errores

400
Validation error in input parameters.
{
    "isError": true,
    "data": {
        "ok": "Request error",
        "message": "The start date must be in ISO format (YYYY-MM-DD)"
    }
}
401
Unauthorized. The authentication token is invalid, has expired, or was not provided.
JWT has expired
404
No master guides found for the client in the specified date range.
{
    "isError": true,
    "data": {
        "ok": "Master guides not found",
        "message": "No master guides were found for the specified client within the given date range."
    }
}
429
The request limit has been exceeded.
Too many requests, please try again later.
500
Internal server error.
{
    "isError": true,
    "data": {
        "ok": "Internal error",
        "message": "An internal error occurred while processing your request."
    }
}