ShippingShipping labels

Get Many Shipping Labels

Get multiple shipping labels with pagination and filtering

GET
/shipos/shipping-labels
x-access-token<token>

In: header

Query Parameters

page?number

Page number for pagination (starting from 0)

Formatdouble
Default0
limit?number

Number of items per page

Formatdouble
Default20
search?string

Search term to filter labels by tracking code, remote ID, or carrier ID

Default""
order_by?string

Field to order results by

Default"created_at"

Value in

  • "created_at"
  • "updated_at"
  • "voided_at"
order?string

Order direction

Value in

  • "asc"
  • "desc"
scan_status?string

Filter by scan status (comma-separated for multiple)

Default""
shipment_status?string

Filter by shipment status (comma-separated for multiple)

Default""
refund_status?string

Filter by refund status (comma-separated for multiple)

Default""
carrier_id?string

Filter by carrier ID (comma-separated for multiple)

Default""
service_id?string

Filter by service ID (comma-separated for multiple)

Default""

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/shipos/shipping-labels"
{  "data": [    {      "formatted_service": "string",      "tracking_url": "string",      "carrier_correction": {        "version": 1,        "source_import": {          "filename": "string",          "import_id": "string"        },        "provider": "EASYPOST",        "format": "UPS_INVOICE_SUMMARY_V1",        "carrier_invoice_number": "string",        "carrier_invoice_date": "string",        "transaction_date": "string",        "confirmed_at": "string",        "tracking_number": "string",        "correction_type": "string",        "correction_reason": "string",        "carrier_service_code": "string",        "published_amount": 0,        "incentive_amount": 0,        "original_carrier_cost": 0,        "carrier_adjustment_amount": 0.1,        "corrected_carrier_cost": 0,        "currency": "AED"      },      "gaylord_id": "string",      "carrier_account_id": "string",      "merchant_team_name": "string",      "merchant_team_id": "string",      "fulfiller_team_name": "string",      "fulfiller_team_id": "string",      "carrier_integration_type": "GENERIC",      "carrier_integration_name": "string",      "carrier_integration_id": "string",      "shipment_status": "LABEL_PRINTED",      "refund_status": "SUBMITTED",      "scan_status": "SCANNED",      "label_with_packing_slip_url": "string",      "original_label_url": "string",      "label_url": "string",      "tracking_code": "string",      "zone": 0,      "delivery_date_guaranteed": true,      "delivery_date": "2019-08-24T14:15:22Z",      "delivery_days": "string",      "to_address_name": "string",      "to_address_company": "string",      "to_address_phone": "string",      "to_address_country": "string",      "to_address_zip": "string",      "to_address_state": "string",      "to_address_city": "string",      "to_address_street2": "string",      "to_address_street1": "string",      "from_address_name": "string",      "from_address_company": "string",      "from_address_phone": "string",      "from_address_country": "string",      "from_address_zip": "string",      "from_address_state": "string",      "from_address_city": "string",      "from_address_street2": "string",      "from_address_street1": "string",      "list_currency": "string",      "list_rate": 0,      "retail_currency": "string",      "retail_price": 0,      "currency": "string",      "price": 0.1,      "carrier_id": "string",      "service_id": "string",      "remote_bukuship_shipment_id": "string",      "remote_easypost_tracker_id": "string",      "remote_id": "string",      "voided_at": "2019-08-24T14:15:22Z",      "shipping_label_number": "string",      "updated_at": "2019-08-24T14:15:22Z",      "created_at": "2019-08-24T14:15:22Z",      "id": "string"    }  ],  "meta": {    "page": 0.1,    "page_size": 0.1,    "has_next_page": true,    "has_previous_page": true,    "start_index": 0.1,    "end_index": 0.1  }}