# Sharkship API Documentation

## Docs
- [Authentication API](https://partner.sharkship.in/authentication-api-9080381f0.md): Authentication is required to access the endpoints of the Sharkship API securely. The authentication token can be used from any system to validate API calls and access Sharkship's resources.
- [Create Orders](https://partner.sharkship.in/create-orders-9080382f0.md): These APIs allow you to create new orders in your Sharkship account, as well as get order details from Sharkship's system.
- [Cancel Orders](https://partner.sharkship.in/cancel-orders-9080383f0.md): These APIs allow you to cancel an existing order and cancel multiple orders in your Sharkship account.
- [Shipping Label](https://partner.sharkship.in/shipping-label-9080384f0.md): The shipping label API lets users to retrieve single shipping or multiple shipping labels associated with their order(s) from Sharkship's system.
- [Shipment Tracking](https://partner.sharkship.in/shipment-tracking-9080385f0.md): The Shipment Tracking API provides functionality to track the status and location of shipments within Sharkship's system.
- [Couriers](https://partner.sharkship.in/couriers-9080386f0.md): This API provides information about courier partners that are available. By making a GET request to the specified endpoint, you can access details regarding various courier service providers.
- [NDR](https://partner.sharkship.in/ndr-9080387f0.md): This API provides access to details about shipments in NDR status within your Sharkship account. You can fetch NDR shipments from your account, either all or specific ones based on AWB number.
- [Pickup Addresses](https://partner.sharkship.in/pickup-addresses-9080388f0.md): Utilize these APIs to retrieve a list of all available pickup locations in your Sharkship account or add a new pickup location.
- [Shipping Rates](https://partner.sharkship.in/shipping-rates-9080389f0.md): These APIs allow you to calculate shipping rates for retail shipments based on source/destination pincodes, weight, dimensions, payment type, and service type.

## API Docs
- Authentication API [Generate API Token](https://partner.sharkship.in/generate-api-token-37959393e0.md): This endpoint generates an API token for authentication. Provide your API secret and key in the request body to obtain access token and refresh token.
- Create Orders [Create Order](https://partner.sharkship.in/create-order-37959394e0.md): Creates a new B2C order.
- Cancel Orders [Cancel Order](https://partner.sharkship.in/cancel-order-37959395e0.md): This endpoint allows you to cancel an order. The request should include a JSON payload in the raw request body type with an array of order IDs of orders which are to be cancelled.
- Shipping Label [Download Shipping Label](https://partner.sharkship.in/download-shipping-label-37959396e0.md): This API allows you to download shipping labels for specific orders. To do so, provide the order IDs for which you need labels in the request body as a JSON payload. Please note that only orders that are in a processed state can be included; shipping labels for CANCELLED and TO_BE_PROCESSED orders cannot be downloaded.
- Shipping Label [Shipping Label Configurations](https://partner.sharkship.in/shipping-label-configurations-37959397e0.md): Retrieves the current shipping label display configurations for your account.
- Shipping Label [Update Shipping Label Configurations](https://partner.sharkship.in/update-shipping-label-configurations-37959398e0.md): Updates shipping label display configurations for your account.
- Shipment Tracking [Tracking](https://partner.sharkship.in/tracking-37959399e0.md): This API allows users to retrieve real-time updates on the movement of their shipments, including expected delivery dates, current locations, and any relevant status updates such as out for delivery or delivered.
- Couriers [Courier Partners](https://partner.sharkship.in/courier-partners-37959400e0.md): This API allows you to retreive a list of all available courier services in your Sharkship account.
- NDR [Reattempt NDR](https://partner.sharkship.in/reattempt-ndr-37959401e0.md): This endpoint facilitates the reattempt of Non-Delivery Report (NDR) for orders. Include the order IDs for which you want to trigger the reattempt in the request body. Additionally, set the header "move_to" to "RE_ATTEMPTED" to specify the action to be taken.
- Pickup Addresses [Pickup Hub ids](https://partner.sharkship.in/pickup-hub-ids-37959402e0.md): Fetches all pickup hubs associated with your Sharkship account.
- Pickup Addresses [Create Pickup Hub Id](https://partner.sharkship.in/create-pickup-hub-id-37959403e0.md): This endpoint enables the creation of a new pickup hub ID. Provide the necessary details in the request body as a JSON payload.
- Pickup Addresses [Pickup Hub Id](https://partner.sharkship.in/pickup-hub-id-37959404e0.md): This endpoint allows you to delete a specific pickup hub identified by its unique ID. Replace `:id` in the URL with the actual ID of the pickup hub you want to delete. This action removes the pickup hub from your Sharkship account.
- Shipping Rates [Get Shipping Rate (Retail)](https://partner.sharkship.in/get-shipping-rate-retail-37959405e0.md): This endpoint retrieves retail shipping rates for a shipment based on source and destination pincodes, payment type, weight, and product value. Dimensions (length, width, height) are passed as request headers.