--- title: "Get order details" method: GET path: "/orders/{orderId}" tags: ["orders"] --- # Get order details `GET /orders/{orderId}` ## Request - Base URL: `https://api.namefi.io/v-next` - URL: `https://api.namefi.io/v-next/orders/{orderId}` - Auth: one of: - API key in header `x-api-key` - HTTP bearer Retrieve detailed information about an order including items, payments, and user details. User must own the order. ## Path parameters - `orderId` string, required ## Headers - `x-namefi-eip7702-account` string - `x-namefi-eip1271-account` string - `x-namefi-erc1271-account` string ## Response `200` OK - object - `order` object, required - `id` string, uuid, required - `userId` string, uuid, required - `status` 'CREATED' | 'PROCESSING' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED' | 'PARTIALLY_COMPLETED', required - `amountInUSDCents` integer, required - `nftWalletAddress` string, nullable, required - `nftChainId` integer, nullable, required - `ledgerHolderType` 'nft' | 'email', nullable, required - `ledgerHolderIdentifier` string, nullable, required - `metadata` object, nullable - `freeClaim` boolean - `groupOrCampaignKey` string - `claimId` string - `stripeFees` object[] - `method` 'card' | 'crypto', required - `paymentAmountBeforeFeesInUsdCents` integer, required: Purchase amount allocated to this Stripe payment, excluding its surcharge; not the whole order total. - `processingSurchargeInUsdCents` integer, required: Amount added to the customer charge to recover estimated fees, including the percentage on the surcharge. - `paymentAmountWithFeesInUsdCents` integer, required: Final Stripe charge: allocated purchase amount plus processing surcharge. - `estimatedFeeRateInBasisPoints` integer, required: Combined estimated processor percentage applied to the final charge; 100 basis points is 1%. - `estimatedFixedFeeInUsdCents` integer, required: Total estimated fixed processor cost per payment, including screening. Do not add screening again. - `estimatedScreeningFeeInUsdCents` integer: Screening component already included in the fixed-fee estimate; not proof of a screening event. - `cardCountry` string: Card issuing country reported by Stripe, when applicable. - `assumedMerchantCountry` string, required: Merchant country assumed by the pricing policy, not verified account configuration. - `assumedSettlementCurrency` string, required: Settlement currency assumed by the pricing policy, not the card currency. - `rounding` 'ceil', required: Round the calculated final charge upward to a whole USD cent. - `mintTransactions` object - `extendTransactions` object - `backfilled_started_finished_at` boolean - `legacyOrderMetadata` object - `source` 'legacy', required - `type` 'legacy-migration', required - `legacyOrderId` string, required - `useNfscBalance` boolean, required - `migratedAt` string, required - `legacyPaymentIntentId` string - `legacyPaymentDetails` object - `status` string, required - `provider` string, required - `paymentType` string, required - `txHash` string - `externalId` string - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `startedAt` string, date-time, nullable, required - `finishedAt` string, date-time, nullable, required - `items` object[], required - `id` string, uuid, required - `orderId` string, uuid, required - `normalizedDomainName` string, required - `amountInUSDCents` integer, required - `durationInYears` integer, required - `type` 'REGISTER' | 'IMPORT' | 'RENEW', required - `registrar` string, required - `encryptionKeyId` string, nullable, required - `encryptedEppAuthorizationCode` string, nullable, required - `status` 'CREATED' | 'PROCESSING' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED' | 'PARTIALLY_COMPLETED', nullable, required - `metadata` object, nullable - `freeClaim` boolean - `groupOrCampaignKey` string - `claimId` string - `emailAcquisitionReceipt` object - `version` unknown, required - `orderId` string, uuid, required - `orderItemId` string, uuid, required - `normalizedDomainName` string, required - `holderIdentifier` string, required - `recordedAt` string, date-time, required - `domainSetupOptions` object - `autoPark` boolean - `autoEns` boolean - `autoRenew` boolean - `dnssec` boolean - `nameservers` unknown[]: At least one unique nameserver hostname, normalized to lowercase ASCII with a trailing dot. Overrides keepExistingNameservers; external nameservers cannot enable Namefi DNSSEC. - unknown - `keepExistingNameservers` boolean - `tldRegistrationRequirementAcknowledged` boolean - `mintTransaction` object - `txHash` string, required - `recordedAt` string, required - `extendTransaction` object - `txHash` string, required - `recordedAt` string, required - `postProcessOrderItem` object - `actions` object[], required - `scope` 'dns-records', required - `action` 'add' | 'set', required - `records` object[], required - `name` string, required - `type` 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS' | 'SOA' | 'PTR' | 'SRV' | 'CAA' | 'DS' | 'TLSA' | 'SSHFP' | 'HTTPS' | 'SVCB' | 'NAPTR' | 'SPF' | 'ANAME', required - `rdata` string, required - `ttl` integer - `requiredAction` 'EPP_UNLOCK_REQUIRED' | 'EPP_AUTH_CODE_UPDATE_REQUIRED' | 'UNDETERMINED' - `failureDetails` object - `requiredAction` 'EPP_UNLOCK_REQUIRED' | 'EPP_AUTH_CODE_UPDATE_REQUIRED' | 'UNDETERMINED', required - `resolution` 'USER_SIGNAL' | 'TIMEOUT', required - `actor` 'USER' | 'ADMIN' - `actorId` string - `timeoutMs` integer - `recordedAt` string, required - `importRenewalShortfall` object - `requestedYears` integer, required - `deliveredYears` integer, required - `undeliveredYears` integer, required - `renewalErrorMessage` string, required - `refundQueuedAmountInUsdCents` integer, required - `recordedAt` string, required - `backfilled_started_finished_at` boolean - `legacyOrderItemMetadata` object - `source` 'legacy', required - `type` 'legacy-migration', required - `legacyItemId` string, required - `chainId` number, required - `receivingWalletAddress` string, nullable, required - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `startedAt` string, date-time, nullable, required - `finishedAt` string, date-time, nullable, required - `payments` object[], required - `id` string, uuid, required - `amountInUSDCents` integer, required - `status` 'CREATED' | 'PROCESSING' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED' | 'REFUND_REQUESTED' | 'REQUIRES_CAPTURE' | 'REFUNDED', required - `paymentProvider` 'NFSC_BASE' | 'NFSC_ETHEREUM' | 'NFSC_ETHEREUM_SEPOLIA' | 'MPP' | 'STRIPE' | 'X402', required - `paymentProviderReferenceId` string, nullable, required - `orderId` string, uuid, nullable, required - `nfscPaymentDetails` union, required - string - number - boolean - object - unknown[] - unknown - `stripePaymentDetails` union, required - string - number - boolean - object - unknown[] - unknown - `metadata` union, required - string - number - boolean - object - unknown[] - unknown - `x402PaymentDetails` union, required - string - number - boolean - object - unknown[] - unknown - `createdAt` string, date-time, required - `updatedAt` string, date-time, required - `startedAt` string, date-time, nullable, required - `finishedAt` string, date-time, nullable, required - `user` object, required - `id` string, uuid, required - `primaryEmail` string, nullable, required - `stripeCustomerId` string, nullable, required - `privyUserId` string, required - `subscribeToEmails` boolean, required - `portfolioPublicEnabled` boolean, required - `portfolioUsername` string, nullable, required - `lastSignInAt` string, date-time, nullable, required - `lastAccessedSessionAt` string, date-time, nullable, required - `lockedDownAt` string, date-time, nullable, required - `preferences` object, required - `defaultAutoEns` boolean, required - `defaultAutoRenew` boolean, required - `createdAt` string, date-time, required - `updatedAt` string, date-time, required ## Other responses - `400`: 400 - `401`: 401 - `402`: 402 - `403`: 403 - `404`: 404 - `406`: 406 - `408`: 408 - `409`: 409 - `412`: 412 - `429`: 429 - `500`: 500 --- [API](https://skmtc.dev/namefi/apis/namefi-api.md) · [All operations](https://skmtc.dev/namefi/apis/namefi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/namefi/apis/namefi-api/revisions/3c7c3ade95c9?raw)