Upload AWB File

PUT/api/pay/v1/orders/{orderId}/awb/{awbId}/upload

Uploads the actual AWB file (PDF/image) for a previously created AWB record.

Prerequisites:

AWB must exist (created via Create AWB API) with status AWB_CAPTURED.
File must be PDF, JPEG, or PNG format.
File size must not exceed 5 MB.
File can only be uploaded once. Re-upload is not allowed.

View as Markdown Open in ChatGPT Open in Claude Open in Perplexity

Requires Bearer token. Get token →

Path Parameters

Name	Type	Description
`orderId`	`string`required	Order ID returned from Create Order API.
`awbId`	`string`required	AWB ID returned from Create AWB API.

Request Body

Name	Type	Description
`file`	`string`required	AWB file to upload. Max size: 5 MB (5,242,880 bytes) Allowed types: application/pdf, image/jpeg, image/jpg, image/png

Response

Name	Type	Description
`awb_id`	`string`	AWB identifier.
`order_id`	`string`	Order ID.
`status`	`AWB_UPLOADED`	Updated to AWB_UPLOADED on success. `AWB_UPLOADED`

Status Codes

`200`	AWB file uploaded successfully.
`400`	Bad Request — Validation error in the request. Possible error codes: - `DOC_MULTIPART_CONTENT_TYPE_REQUIRED` — Content-Type must be multipart/form-data - `DOC_FILE_MISSING` — No file found in the multipart body - `DOC_INVALID_FILE_TYPE` — File type not allowed (must be PDF/JPEG/PNG) - `DOC_FILE_TOO_LARGE` — File exceeds 5 MB limit - `DOC_ORDER_ID_MISSING` — orderId path parameter is missing - `DOC_AWB_ID_MISSING` — awbId path parameter is missing
`404`	Not Found — AWB not found.
`409`	Conflict — AWB file already uploaded. File upload is a one-time operation.
`500`

Request

curl --request PUT \
  --url https://pluraluat.v2.pinepg.in/api/pay/v1/orders/%7BorderId%7D/awb/%7BawbId%7D/upload \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  --header 'Content-Type: multipart/form-data'

Run this request

Bearer token

Path parameters

orderId

awbId

Request body (JSON)

200 OK

{
  "awb_id": "awb-260522-001",
  "order_id": "v1-260520225359-aa-LHy288",
  "status": "AWB_UPLOADED"
}