# Query Insurance Rate

Endpoint: GET /api/shipment/insurance/rate
Version: v2
Security: BearerAuth

## Query parameters:

  - `declared_value` (number, required)
    Declared value for shipment insurance, representing the insured amount in USD.
    Example: 200

  - `service_level` (string, required)
    The insurance quote request must specify a service_level. Pricing varies depending on the selected service level.
    Example: "USPS_GROUND_ADVANTAGE"

## Response 200 fields (application/json):

  - `code` (string)
    Example: "ok"

  - `msg` (string)
    Example: "ok"

  - `data` (object)

  - `data.carrier` (string)
    Carrier code identifier.
    Enum: "USPS", "UPS", "FEDEX", "DHL_EXPRESS", "SWIFTX", "GOFO_EXPRESS", "UPS_CANADA"

  - `data.rate_id` (string)
    The unique identifier of an insurance rate returned by the /api/shipment/insurance/rate endpoint. Use this value to purchase insurance for a shipment.
    Example: "dc288147-f7dd-494d-9353-5ce00020c7aa"

  - `data.service_level` (string)
    Carrier service level. See [Appendix - Carrier Service Types](../../../../appendix.md) for the valid relationships between carrier_code, provider_id, and service_level.
    Enum: "USPS_FIRST_CLASS_MAIL", "USPS_GROUND_ADVANTAGE", "USPS_PRIORITY_MAIL", "USPS_PRIORITY_MAIL_EXPRESS", "USPS_MEDIA_MAIL", "USPS_LIBRARY_MAIL", "USPS_FIRST_CLASS_MAIL_INTERNATIONAL", "USPS_PRIORITY_MAIL_INTERNATIONAL", "USPS_PRIORITY_MAIL_EXPRESS_INTERNATIONAL", "UPS_GROUND", "UPS_GROUND_SAVER", "UPS_NEXT_DAY_AIR", "UPS_NEXT_DAY_AIR_SAVER", "UPS_NEXT_DAY_AIR_EARLY", "UPS_2ND_DAY_AIR", "UPS_2ND_DAY_AIR_AM", "UPS_3_DAY_SELECT", "UPS_STANDARD", "UPS_WORLDWIDE_SAVER", "UPS_WORLDWIDE_EXPRESS", "UPS_WORLDWIDE_EXPRESS_PLUS", "UPS_WORLDWIDE_EXPEDITED", "UPS_SUREPOST_LESS_THAN_1_LB", "UPS_SUREPOST_1_LB_OR_GREATER", "FEDEX_GROUND", "FEDEX_2_DAY", "FEDEX_2_DAY_AM", "FEDEX_EXPRESS_SAVER", "FEDEX_STANDARD_OVERNIGHT", "FEDEX_FIRST_OVERNIGHT", "FEDEX_PRIORITY_OVERNIGHT", "FEDEX_INTERNATIONAL_ECONOMY", "FEDEX_INTERNATIONAL_FIRST", "FEDEX_INTERNATIONAL_PRIORITY", "FEDEX_HOME_DELIVERY", "FEDEX_SMARTPOST", "FEDEX_STANDARD_OVERNIGHT_EXTRA_HOURS", "FEDEX_FIRST_OVERNIGHT_EXTRA_HOURS", "FEDEX_PRIORITY_OVERNIGHT_EXTRA_HOURS", "FEDEX_INTERNATIONAL_PRIORITY_EXPRESS", "FEDEX_INTERNATIONAL_CONNECT_PLUS", "FEDEX_DATE_CERTAIN_HOME_DELIVERY", "FEDEX_EVENING_HOME_DELIVERY", "FEDEX_APPOINTMENT_HOME_DELIVERY", "FEDEX_INTERNATIONAL_PRIORITY_PR", "DHL_EXPRESS_WORLDWIDE_B2C", "DHL_EXPRESS_WORLDWIDE_B2C_NONDOC", "DHL_EXPRESS_JET_LINE_NONDOC", "DHL_EXPRESS_SPRINT_LINE", "DHL_EXPRESS_EURO_PACK_DOC", "DHL_EXPRESS_BREAK_BULK_EXPRESS", "DHL_EXPRESS_MEDICAL_EXPRESS", "DHL_EXPRESS_WORLDWIDE_DOC", "DHL_EXPRESS_0900_NONDOC", "DHL_EXPRESS_FREIGHT_WORLDWIDE_NONDOC", "DHL_EXPRESS_DOMESTIC_ECONOMY_SELECT", "DHL_EXPRESS_ECONOMY_SELECT_NONDOC", "DHL_EXPRESS_DOMESTIC_EXPRESS_0900", "DHL_EXPRESS_JUMBO_BOX_NONDOC", "DHL_EXPRESS_0900", "DHL_EXPRESS_1030", "DHL_EXPRESS_1030_NONDOC", "DHL_EXPRESS_DOMESTIC_EXPRESS", "DHL_EXPRESS_DOMESTIC_EXPRESS_1030", "DHL_EXPRESS_WORLDWIDE_NONDOC", "DHL_EXPRESS_MEDICAL_EXPRESS_NODOC", "DHL_EXPRESS_GLOBAL_MAIL_BUSINESS", "DHL_EXPRESS_SAME_DAY", "DHL_EXPRESS_1200_DOC", "DHL_EXPRESS_WORLDWIDE_ECX", "DHL_EXPRESS_EURO_PACK_NONDOC", "DHL_EXPRESS_ECONOMY_SELECT", "DHL_EXPRESS_ENVELOPE", "DHL_EXPRESS_1200_NONDOC", "DHL_EXPRESS_DOMESTIC_EXPRESS_1200", "GOFO_EXPRESS_ECO", "SWIFTX_EXP", "UPS_CANADA_EXPEDITED", "UPS_CANADA_EXPRESS_EARLY", "UPS_CANADA_EXPRESS_SAVER", "UPS_CANADA_EXPRESS", "UPS_CANADA_STANDARD", "UPS_CANADA_3_DAY_SELECT", "UPS_CANADA_EXPRESS_EARLY_SM", "UPS_CANADA_WORLDWIDE_EXPEDITED_SM", "UPS_CANADA_WORLDWIDE_EXPRESS_PLUS_SM", "UPS_CANADA_WORLDWIDE_EXPRESS_SM", "UPS_CANADA_EXPRESS_SAVER_SM"

  - `data.rate` (number)
    Insurance cost for the specified service level and declared value.
    Example: 1.98

  - `data.declared_value` (number)
    Declared shipment value for insurance coverage calculation.
    Example: 200