# Get carrier by ID

Retrive carrier info by ID

Endpoint: GET /v1/carriers/{carrier_id}
Version: 1.1.202604070904
Security: api_key

## Path parameters:

  - `carrier_id` (string, required)
    Carrier ID
    Example: "se-28529731"

## Response 200 fields (application/json):

  - `carrier_id` (string)
    A string that uniquely identifies the carrier.
    Example: "se-28529731"

  - `carrier_code` (string)
    The shipping carrier who will ship the package, such as fedex, dhl_express, stamps_com, etc.
    Example: "dhl_express"

  - `account_number` (string)
    The account number that the carrier is connected to.
    Example: "account_570827"

  - `requires_funded_amount` (boolean)
    Indicates whether the carrier requires funding to use its services

  - `balance` (number)
    Current available balance
    Example: 3799.52

  - `nickname` (string)
    Nickname given to the account when initially setting up the carrier.
    Example: "ShipEngine Account - Stamps.com"

  - `friendly_name` (string)
    Screen readable name
    Example: "Stamps.com"

  - `funding_source_id` (string,null)
    Funding source ID for the carrier
    Example: "se-28529731"

  - `primary` (boolean)
    Is this the primary carrier that is used by default when no carrier is specified in label/shipment creation

  - `has_multi_package_supporting_services` (boolean)
    Carrier supports multiple packages per shipment

  - `allows_returns` (boolean)
    The carrier has services that support return shipments.

  - `supports_label_messages` (boolean)
    The carrier supports adding custom label messages to an order.

  - `disabled_by_billing_plan` (boolean)
    The carrier is disabled by the current ShipEngine account's billing plan.

  - `services` (array)
    A list of services that are offered by the carrier

  - `services.carrier_id` (string)
    A string that uniquely identifies the carrier
    Example: "se-28529731"

  - `services.carrier_code` (string)
    A string that uniquely identifies a ShipEngine resource, such as a carrier, label, shipment, etc.
    Example: "se-28529731"

  - `services.service_code` (string)
    service code
    Example: "usps_media_mail"

  - `services.name` (string)
    User friendly service name
    Example: "USPS First Class Mail"

  - `services.domestic` (boolean)
    Supports domestic shipping

  - `services.international` (boolean)
    Supports international shipping.

  - `services.is_multi_package_supported` (boolean)
    Carrier supports multiple packages per shipment

  - `services.is_return_supported` (boolean)
    This service supports return shipments.

  - `services.send_rates` (boolean)
    The service provides rates for the shipment.
    Example: true

  - `packages` (array)
    A list of package types that are supported by the carrier

  - `packages.package_id` (string)
    A string that uniquely identifies the package.
    Example: "se-28529731"

  - `packages.package_code` (string, required)
    A unique identifier for the package type.
    Example: "package"

  - `packages.name` (string, required)
    Example: "laptop_box"

  - `packages.dimensions` (object)
    The dimensions for the package.

  - `packages.dimensions.unit` (string, required)
    The dimension units that are supported by ShipEngine.
    Enum: "inch", "centimeter"

  - `packages.dimensions.length` (number, required)
    The length of the package, in the specified unit

  - `packages.dimensions.width` (number, required)
    The width of the package, in the specified unit

  - `packages.dimensions.height` (number, required)
    The height of the package, in the specified unit

  - `packages.description` (string,null)
    Provides a helpful description for the package.
    Example: "Packaging for laptops"

  - `options` (array)
    A list of options that are available to that carrier

  - `options.name` (string)
    Name of advanced option
    Example: "contains_alcohol"

  - `options.default_value` (string)
    Default value of option
    Example: "false"

  - `options.description` (string)
    Description of option

  - `send_rates` (boolean)
    The carrier provides rates for the shipment.
    Example: true

  - `supports_user_managed_rates` (boolean)
    The carrier supports user-managed rates for shipments.

  - `connection_status` (string)
    The current connection status of the carrier. Indicates whether the carrier connection is pending approval or has been approved for use.
    Enum: "pending_approval", "approved"

## Response 400 fields (application/json):

  - `request_id` (string, required)
    A UUID that uniquely identifies the request id.
This can be given to the support team to help debug non-trivial issues that may occur
    Example: "aa3d8e8e-462b-4476-9618-72db7f7b7009"

  - `errors` (array, required)
    The errors associated with the failed API call

  - `errors.error_source` (string, required)
    The source of the error, as indicated by the name this informs us if the API call failed because of the
carrier, the order source, or the ShipEngine API itself.
    Enum: "carrier", "order_source", "shipengine"

  - `errors.error_type` (string, required)
    The type of error
    Enum: "account_status", "business_rules", "validation", "security", "system", "integrations"

  - `errors.error_code` (string, required)
    The error code specified for the failed API Call
    Enum: "auto_fund_not_supported", "batch_cannot_be_modified", "carrier_conflict", "carrier_disconnected", "carrier_not_connected", "carrier_not_supported", "confirmation_not_supported", "default_warehouse_cannot_be_deleted", "field_conflict", "field_value_required", "forbidden", "identifier_conflict", "identifiers_must_match", "insufficient_funds", "invalid_address", "invalid_billing_plan", "invalid_field_value", "invalid_identifier", "invalid_status", "invalid_string_length", "label_images_not_supported", "meter_failure", "order_source_not_active", "rate_limit_exceeded", "refresh_not_supported", "request_body_required", "return_label_not_supported", "settings_not_supported", "subscription_inactive", "terms_not_accepted", "tracking_not_supported", "trial_expired", "unauthorized", "unknown", "unspecified", "verification_failure", "warehouse_conflict", "webhook_event_type_conflict", "customs_items_required", "incompatible_paired_labels", "invalid_charge_event", "invalid_object", "no_rates_returned", "file_not_found", "shipping_rule_not_found", "service_not_determined", "no_rates_returned", "funding_source_registration_in_progress", "insurance_failure", "funding_source_missing_configuration", "funding_source_error", "freight_connection_inactive", "freight_provider_id_required", "freight_provider_already_connected", "freight_shipment_not_found", "freight_tracking_not_available", "freight_tracking_not_found", "freight_shipment_not_batchable"

  - `errors.message` (string, required)
    An error message associated with the failed API call
    Example: "Body of request cannot be null."

  - `errors.carrier_id` (string)
    A string that uniquely identifies the carrier that generated the error.
    Example: "se-28529731"

  - `errors.carrier_code` (string)
    The name of the shipping carrier that generated the error, such as fedex, dhl_express, stamps_com, etc.
    Example: "dhl_express"

  - `errors.field_name` (string)
    The name of the field that caused the error
    Example: "shipment.ship_to.phone_number"