TABLE OF CONTENTS



The uploadDocument API is a dedicated file binary upload endpoint. It allows Sellers/Agents to upload official proof documents (such as medical certificates, death certificates, or visa denials) required for refund, flight time change or other postbooking scenarios that required document proof.

VersionDateDescription of Edit
V2.02026/08/15Initial Commit


Request Details
Pathv2.0/api/flight/connectivity/order/V2.0/uploadDocument


Request Payload Example

curl --location --request POST 'https: //{host}/api/V2.0/uploadDocument' \
   --header 'Content-Type: multipart/form-data' \
   --form 'documentType=MEDICAL_CERTIFICATE' \
   --form 'file=@/path/to/medical-certificate.pdf'


Request Payload Structure



KeyParentTypeMandatory/OptionalDescription
documentTyperootStringMEnum:
Medical & Health Conditions
  • MEDICAL_CERTIFICATE 
  • PREGNANCY_PROOF 
  • QUARANTINE_ORDER 
Bereavement & Life Events 
  • DEATH_CERTIFICATE 
  • RELATIONSHIP_PROOF 
Legal & Government Obligations
  • MILITARY_ORDER 
  • COURT_SUMMONS 
  • Identity & Immigration Disruptions 
  • VISA_DENIAL_LETTER 
  • PASSPORT_LOSS_REPORT 
IMMIGRATION_RESTRICTION 
  • Irregularity & Transportation Disruption 
  • FLIGHT_DELAY_NOTICE 
  • FORCE_MAJEURE_NOTICE 
Fallback Generic Category 
  • OTHER
filerootFileMThe actual file object. Allowed: .jpg, .jpeg, .png, .pdf. Max: 5MB.



Response


Response Payload Example

{
   "error": null,
   "documentId": "file_01HXYZ1234567890",
   "fileName": "medical-certificate.pdf",
   "expireTime": "1791623460000"
}


KeyParentTypeMandatory/OptionalDescription
documentIdrootStringM[Since v2.0] The globally unique identifier generated by GDN for the uploaded file. This ID will be referenced in the documentsId[] array within orderChange requests.
fileNamerootStringM[Since v2.0] The original filename of the uploaded attachment.
file_name Parameter Rule: Must not exceed 255 characters and must end with a valid extension (e.g., .pdf, .jpg).
Forbidden Characters: Slashes (/, \), Colons (:), Asterisks (*), Question Marks (?), Quotes ("), Angle Brackets (<, >), Pipes (|), Null Bytes (\0), or starting with a leading period (.).

(All other global Unicode characters, letters, numbers, hyphens, and underscores are accepted.)
expireTimerootStringM[Since v2.0] Expiration timestamp of the uploaded document represented as a Unix timestamp in milliseconds (e.g., "1786705920000"). Default validity is 30 minutes from upload.
errorrootObjectO[Since v2.0]