- What you receive
- contacts.vcf — combined vCard 4.0 import file; catalog.json — validated normalized contacts; README.md — import guidance and use rights; gateway-manifest.json — member SHA-256 hashes. Private access follows the service-specific retention terms.
- Input required
- Use the exact hosted input schema and purchase.request example.
- Output
- contacts.vcf — combined vCard 4.0 import file; catalog.json — validated normalized contacts; README.md — import guidance and use rights; gateway-manifest.json — member SHA-256 hashes
- Pricing basis
- Price per completed job. Review supported inputs, processing scope and live availability before checkout.
- Availability
- Wallet API available. Review the exact quote before payment. Browser checkout is separately qualified.
Browser checkout: available.
- Product ID
contact-import-bundle
Scope & limitations
- Upload strict UTF-8 JSON with contacts. Each contact requires uid, formattedName and name containing family and given; at least one of family or given must be nonblank. Optional fields are emails, telephones, organization, address and revision. Duplicate JSON keys and unsupported fields reject before checkout; raw vCard files are unsupported.
- UIDs use the declared 36-character hyphenated UUID profile, version 1–8 and RFC variant, and normalize to lowercase; duplicates reject ignoring ASCII case. Each card includes FN and five-component N. Optional address requires nonblank street, locality and country; poBox, extended, region and postalCode are optional. Optional revision must be an explicit valid UTC YYYYMMDDTHHMMSSZ; no revision time is invented.
- Up to 256 KiB input and 256 contacts. Names, organization components and address components are limited to 512 UTF-16 code units each. Up to eight email addresses and eight telephone numbers per contact, one organization with up to four units and one postal address. Generated members and their path names total at most 2 MiB before the delivery manifest.
- Email addresses use the declared unquoted ASCII dot-atom profile, at most 254 characters with a local part up to 64, and an ASCII DNS domain with at least two labels. Telephone values are + followed by 2–15 digits, starting with a nonzero digit; extensions and local-number context are unsupported. Syntax validation does not verify assignment, domain existence, deliverability or reachability.
- Produces the declared vCard 4.0 profile with escaped text, CRLF endings and UTF-8 content lines folded to at most 75 octets. catalog.json normalizes UUID case and text line endings. Back up your address book and test a small import. No account access, lookup, enrichment, merge, deduplication, sending, photos, URLs or import is performed; field handling and repeated imports vary by application, with no compatibility certification.
- Nonexclusive buyer's own personal or internal business use; no resale, redistribution or sublicensing of Gateway's first-party bundle. Customer-provided contacts, data and pre-existing rights remain with their owners; preserve applicable third-party licenses. No MIT or other open-source license is granted.
- USD 19.00 per one-time prepared ZIP; no subscription. Save the ZIP before its disclosed expiry.
Technical references
Qualified hosted service; current wallet availability checked at discovery