Recolecciones

Recupera recolecciones con sus envíos

   GET /api/v2/pickups?page={page}&per_page={per_page}

Devuelve las recolecciones de la cuenta, paginadas. A diferencia de GET /api/v1/pickups, cada recolección trae todos los envíos que cubre en la relación shipments, en vez de un solo reference_shipment, y el campo manifest_url.

get/api/v2/pickups

Request

Base URL: https://api-pro.skydropx.com
URL: https://api-pro.skydropx.com/api/v2/pickups
Auth: HTTP bearer

Query parameters

pageinteger

Example:1

Número de página a recuperar

per_pageinteger

Example:20

Número de elementos por página (máximo 20, por defecto 20)

Response

Retorna una colección paginada de recolecciones con sus envíos

Example response

{
  "data": [
    {
      "id": "ed06f78a-8757-488c-bb82-31964449aea0",
      "type": "pickup",
      "attributes": {
        "id": "ed06f78a-8757-488c-bb82-31964449aea0",
        "status": "scheduled",
        "request_number": "123456789",
        "packages": 3,
        "total_weight": "30.0",
        "scheduled_from": "2026-10-01T09:00:00.000-06:00",
        "scheduled_to": "2026-10-01T14:00:00.000-06:00",
        "created_at": "2026-09-30T08:55:50.992-06:00",
        "updated_at": "2026-09-30T08:55:50.992-06:00",
        "manifest_url": "https://example.com/rails/active_storage/blobs/manifest.pdf"
      },
      "relationships": {
        "shipments": {
          "data": [
            {
              "id": "d4ad5784-4f71-4474-9f34-e2a6f8366d5e",
              "type": "shipment"
            }
          ]
        },
        "address": {
          "data": {
            "id": "901e4d68-a147-4fdf-9078-c252a672611c",
            "type": "simple_address"
          }
        }
      }
    }
  ],
  "included": [
    {
      "attributes": {
        "id": "0ac5adcc-a13d-427d-81dd-9ddd70b2f660",
        "carrier_name": "FEDEX",
        "service_name": "Express Saver",
        "service_code": "fedex_express_saver",
        "shipment_scope": "national",
        "estimated_delivery_days": 3,
        "workflow_status": "success",
        "payment_status": "paid",
        "total": "500.0",
        "source": "api",
        "carrier_id": "91dd6bde-fd08-4bf2-b12d-d79c98b0f7ab",
        "service_id": "91dd6bde-fd08-4bf2-b12d-d79c98b0f7ab",
        "master_tracking_number": "234234234233",
        "original_shipment_id": "0199977a-e032-78bf-a335-00a9ae3cfdff",
        "error_detail": {
          "error_code": "ERR_INVALID_ADDRESS",
          "error_message": "La dirección de destino no es válida",
          "error_message_detail": "Token no válido"
        },
        "order_detail_url": "https://example.com/order_detail.pdf"
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "next_page": 2,
    "total_pages": 3,
    "total_count": 45
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.