Skip to content
KasblyKasbly Docs

Attach customs documents to order

PATCH
/api/v1/orders/{id}/customs-documents
curl --request PATCH \
  --url https://api.dokanmazad.com/api/v1/orders/cmosor2zy000313ny24hgtfy0/customs-documents \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "documents": [ { "type": "bill_of_lading", "url": "https://cdn.dokanmazad.com/docs/bol-001.pdf", "uploadedAt": "2026-05-10T12:00:00Z" } ] }'

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
id
required
string

Order ID (CUID)

Example
cmosor2zy000313ny24hgtfy0

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
documents
required

Array of customs document objects — shape is flexible JSON stored on the order

Array
Examples
Exampledefault
{
  "documents": [
    {
      "type": "bill_of_lading",
      "url": "https://cdn.dokanmazad.com/docs/bol-001.pdf",
      "uploadedAt": "2026-05-10T12:00:00Z"
    }
  ]
}

Responses

Section titled “Responses”

200

Section titled “200”

Success

Media typeapplication/json
object
success
required
boolean
data
required
meta
object
page
integer
limit
integer
total
integer
totalPages
integer
data
required
object
documents
required

Updated customs documents array

Array
Examples
Examplesuccess
{
  "success": true,
  "data": {
    "documents": [
      {
        "type": "bill_of_lading",
        "url": "https://cdn.dokanmazad.com/docs/bol-001.pdf",
        "uploadedAt": "2026-05-10T12:00:00Z"
      }
    ]
  }
}

401

Section titled “401”

Unauthorized — missing or invalid API key

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

403

Section titled “403”

Forbidden — route not in this key’s allowedRoutes

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

429

Section titled “429”

Rate limit exceeded

Media typeapplication/json
object
success
required
boolean
error
required
string
statusCode
required
integer
Example
{
  "success": false
}

Headers

Section titled “Headers”
Retry-After
integer

Seconds to wait before retrying