--- title: "Get customs entry details" method: GET path: "/api/v1/external/customs-entries/{entryId}/details" tags: ["Customs Entries"] --- # Get customs entry details `GET /api/v1/external/customs-entries/{entryId}/details` ## Request - Base URL: `https://api.wove.com` - URL: `https://api.wove.com/api/v1/external/customs-entries/{entryId}/details` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieve a customs entry with its invoices, containers and packing lines, plus its lines. Requires `customs:read`. ## Path parameters - `entryId` string, required ## Response `200` Customs entry details retrieved successfully - object - `success` boolean - `data` object - `customsEntry` object: A customs entry header. Decimal amounts stored as numerics (totalCustomsValue, totalDuties, totalTaxes, totalFees) are returned as strings to preserve precision. - `creation` EntityCreationInfo: How the record came into existence. `user` is a person in Wove (manual); `email`, `document_upload`, `bulk_upload`, `tms_import` and `api` are Wove-created from that source; `system` is created by Wove with no further source. `null` means nothing was recorded (most records created before October 2026): treat it as unknown, not as manual. - `source` 'user' | 'email' | 'document_upload' | 'bulk_upload' | 'tms_import' | 'api' | 'system' | 'null', nullable - `sync` EntitySyncInfo, nullable: The latest push of the record to your TMS (e.g. CargoWise), the same one the Sync Reports in Wove show. `null` when the record was never synced. - `method` 'automation' | 'manual' | 'webhook': An automation rule pushed it, a person pushed it, or a webhook did - `status` string - `syncedAt` string, date-time, nullable - `syncedBy` object, nullable: The person who pushed it. `null` for an automation or webhook push, and for a manual push recorded before Wove kept who made it. - `userId` string - `name` string, nullable - `email` string, nullable - `tmsReference` string, nullable: The record's reference in the TMS (for a shipment, the job it was pushed to) - `id` string - `shipmentId` string, nullable - `branchId` string, nullable - `teamId` string, nullable - `entryNumber` string, nullable - `entryType` '01' | '11' | 'export' | 'in_bond' | 'ca_b3' | 'ca_clvs' | 'ca_type_f' | 'null', nullable - `status` 'pending' | 'draft' | 'review' | 'filed' | 'released' | 'liquidated' | 'cancelled' - `syncStatus` string, nullable: TMS sync status, separate from the customs status lifecycle - `tmsSyncedAt` string, date-time, nullable - `complianceStatus` string, nullable - `filingCountry` string, nullable - `customsAuthority` string, nullable - `portOfEntry` CustomsEntryPort, nullable - `type` string - `portCode` string - `portName` string - `country` string: ISO-2 country code, empty when the LOCODE is unknown - `portOfLoading` CustomsEntryPort, nullable - `type` string - `portCode` string - `portName` string - `country` string: ISO-2 country code, empty when the LOCODE is unknown - `portOfOrigin` CustomsEntryPort, nullable - `type` string - `portCode` string - `portName` string - `country` string: ISO-2 country code, empty when the LOCODE is unknown - `portOfDischarge` CustomsEntryPort, nullable - `type` string - `portCode` string - `portName` string - `country` string: ISO-2 country code, empty when the LOCODE is unknown - `portOfDestination` CustomsEntryPort, nullable - `type` string - `portCode` string - `portName` string - `country` string: ISO-2 country code, empty when the LOCODE is unknown - `regime` string, nullable - `importerName` object, nullable: Party reference - `id` string - `name` string - `importerAddress` object, nullable - `importerTaxId` string, nullable - `exporterName` object, nullable: Party reference - `id` string - `name` string - `exporterAddress` object, nullable - `brokerName` object, nullable: Party reference - `id` string - `name` string - `brokerAddress` object, nullable - `brokerReference` string, nullable - `sendingAgentName` object, nullable: Party reference - `id` string - `name` string - `sendingAgentAddress` object, nullable - `totalPacks` number, nullable - `totalPacksPackageType` string, nullable - `totalNoOfPieces` number, nullable - `totalWeight` number, nullable - `weightUnit` string, nullable - `totalVolume` number, nullable - `volumeUnit` string, nullable - `entryDate` string, date, nullable - `arrivalDate` string, date-time, nullable - `releaseDate` string, date, nullable - `liquidationDate` string, date, nullable - `departureDate` string, date, nullable - `totalCustomsValue` string, nullable - `totalDuties` string, nullable - `totalTaxes` string, nullable - `totalFees` string, nullable - `currency` string, nullable - `authorityReference` string, nullable - `amendmentType` string, nullable - `originalEntryNumber` string, nullable - `filingMethod` string, nullable - `sourceSystem` string, nullable - `fieldSources` object, nullable: Per-field provenance of extracted values - `aiInputSnapshot` object, nullable - `transportMode` string, nullable - `vesselName` string, nullable - `voyageFlightNo` string, nullable - `lloydsImo` string, nullable - `masterBill` string, nullable - `houseBill` string, nullable - `externalShipmentRefId` string, nullable - `manifestNumber` string, nullable - `poNumber` string, nullable - `carrierCode` string, nullable - `lvsId` string, nullable - `cadTransactionNumber` string, nullable - `portOfClearance` string, nullable - `subLocationCode` string, nullable - `subLocationDescription` string, nullable - `examLocationCode` string, nullable - `examLocationDescription` string, nullable - `incoterm` string, nullable - `carrier` object, nullable - `id` string - `code` string - `name` string - `previousExportMrn` string, nullable - `deliveryNoteNumber` string, nullable - `customsOfficeOfExit` string, nullable - `vehicleRegistration` string, nullable - `lineCount` integer - `documentCount` integer - `tmsReference` string, nullable - `allTmsReferences` string, nullable: Comma-separated list of every TMS reference the entry is synced under - `tmsType` string, nullable - `tags` object[] - `description` string - `effectiveFrom` string, date - `authority` string, nullable - `condition` string, nullable - `sourceReference` string, nullable - `supersededDuties` string[] - `availableExclusions` string[]: Exclusion or exemption codes an importer could claim. - `requiredInputs` string[]: Keys of inputs needed for an exact calculation, e.g. `steel`, `steel.countryOfMelt`, `quantity`. - `invoices` CustomsEntryInvoice[] - `id` string - `customsEntryId` string - `invoiceNumber` string, nullable - `invoiceDate` string, date, nullable - `invoiceAmount` number, nullable - `invoiceCurrency` string, nullable - `incoTerm` string, nullable - `incoTermPlace` string, nullable - `paymentTerms` string, nullable - `valuationBasis` string, nullable - `supplierName` object, nullable: Party reference - `id` string - `name` string - `supplierAddress` object, nullable - `supplierRegistrationNumbers` unknown - `buyerName` object, nullable: Party reference - `id` string - `name` string - `buyerAddress` object, nullable - `buyerRegistrationNumbers` unknown - `commercialCharges` unknown - `noOfPacks` number, nullable - `grossWeight` number, nullable - `grossWeightUom` string, nullable - `netWeight` number, nullable - `netWeightUom` string, nullable - `volume` number, nullable - `volumeUom` string, nullable - `exportLicenseNumber` string, nullable - `preferentialOriginClaim` boolean - `createdAt` string, date-time - `updatedAt` string, date-time - `containers` CustomsEntryContainer[] - `id` string - `customsEntryId` string - `containerNumber` string, nullable - `containerType` string, nullable - `sealNumber` string, nullable - `createdAt` string, date-time - `updatedAt` string, date-time - `packingLines` CustomsEntryPackingLine[] - `id` string - `customsEntryId` string - `lineNumber` integer, nullable - `packageNumbers` string, nullable - `packageCount` integer, nullable - `packageType` string, nullable - `marksAndNumbers` string, nullable - `sealNumber` string, nullable - `grossWeight` number, nullable - `grossWeightUom` string, nullable - `netWeight` number, nullable - `netWeightUom` string, nullable - `tareWeight` number, nullable - `tareWeightUom` string, nullable - `length` number, nullable - `width` number, nullable - `height` number, nullable - `dimensionUom` string, nullable - `volume` number, nullable - `volumeUom` string, nullable - `countryOfOrigin` string, nullable - `hsCode` string, nullable - `fieldSources` object, nullable - `createdAt` string, date-time - `updatedAt` string, date-time - `lines` CustomsEntryLine[] - `id` string - `customsEntryId` string - `customsEntryInvoiceId` string, nullable - `lineNumber` integer, nullable - `shipmentContainerId` string, nullable - `shipmentPackageId` string, nullable - `shipmentPackageItemId` string, nullable - `sku` string, nullable - `partNumber` string, nullable - `description` string, nullable - `hsCode` string, nullable - `countryOfOrigin` string, nullable - `customsValue` string, nullable - `currency` string, nullable - `customsQuantity` string, nullable - `customsQuantityUom` string, nullable - `statisticalQuantity` string, nullable - `statisticalQuantityUom` string, nullable - `grossWeight` string, nullable - `grossWeightUom` string, nullable - `netWeight` string, nullable - `netWeightUom` string, nullable - `volume` string, nullable - `volumeUom` string, nullable - `dutyRate` string, nullable - `tariffTreatmentCode` string, nullable - `dutyAmount` string, nullable - `taxRate` string, nullable - `taxAmount` string, nullable - `lineStatus` 'draft' | 'review' | 'final' | 'cancelled' | 'null', nullable - `pgaFlags` unknown - `fieldSources` object, nullable - `createdAt` string, date-time - `updatedAt` string, date-time ## Other responses - `401`: Authentication required or invalid credentials - `403`: Insufficient permissions - `404`: Resource not found --- [API](https://skmtc.dev/wove/apis/wove-external-api.md) - [All operations](https://skmtc.dev/wove/apis/wove-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/wove/apis/wove-external-api/revisions/37290e267e07?raw)