Nearwell export formats
Version of 13 November 2026.
In Nearwell, under Settings, Your data, you download what you keep here in four files. Together they hold everything; the only things left out are your password hash and the key in the daily email's unsubscribe link, for security. All text is UTF-8.
Everything, as JSON
contacts-YYYY-MM-DD.json: one JSON object, Nearwell's own format (not an open standard). Dates are YYYY-MM-DD; moments are ISO 8601 with a time zone. A field without a value is null.
| Field | Content |
|---|---|
app | "Nearwell" |
version | 2: the version of this format |
exportedOn | the day of the export |
account.email | your email address |
account.displayName | your name, if you filled it in |
account.locale | "en" or "nl" |
account.businessUseConfirmedAt | when you confirmed use for work or business |
account.termsVersion, account.termsAcceptedAt | which version of the terms you accepted (its date), and when |
account.google | if you continued with Google, what Google handed over: id, email, name, pictureUrl; otherwise null |
account.settings.opportunities | whether Opportunities is on (true or false) |
account.settings.dailyEmail | whether the daily email is on |
companies, categories, tags | every name you use, also one no person has, as lists of text |
notTheSamePerson | pairs of person ids you marked as not the same person |
contacts | the people, below |
Each person in contacts:
| Field | Content |
|---|---|
id | the person's id (a UUID), also used in notTheSamePerson and the photo file names |
fullName | name |
company, jobTitle, email, phone | text |
linkedinUrl | a link |
otherLinks | a list of links |
metWhere | where you know them from |
strength | new, developing, active, strong or dormant |
category | a category name |
tags | a list of tag names |
note | free text |
reconnectDays | after how many days you want to be in touch again |
reconnectSnoozedUntil | until when that is snoozed |
hasPhoto | whether there is a photo in the photo file |
createdAt, updatedAt | when the person was added and last changed |
interactions | a list: kind (meeting, call, email, message or other), occurredOn, note, createdAt |
tasks | a list: title, opportunity (the title of the related opportunity), dueOn, priority (high, normal or low), doneAt, createdAt |
opportunities | a list: title, stage (qualified, discovery, proposal, negotiation, won or lost), valueEur (whole euros), note, createdAt, updatedAt |
Photos, as ZIP
photos-YYYY-MM-DD.zip: one JPEG file per person with a photo, named after the person and ending in their id from the JSON file: name-id.jpg.
People, as CSV
contacts-YYYY-MM-DD.csv: starts with a byte order mark (so spreadsheets read it as UTF-8), comma separated, CRLF line ends, a header row, a field in double quotes only where needed. The columns: Name, Company, Role, Email, Phone, LinkedIn, Other links (separated by spaces), Where you met, Relationship (the values of strength above), Category, Tags (separated by a comma and a space), Note. A cell a spreadsheet would run as a formula starts with an apostrophe. Interactions, tasks, reminders and opportunities are not in this file.
People, as vCard
contacts-YYYY-MM-DD.vcf: vCard 3.0 (RFC 2426), one card per person, with the name, company, job title, email address, phone number, links, note, and the tags as categories. Like the CSV file, it holds only a person's own fields.
Bringing it back
Nearwell imports its own CSV and vCard files, and a Google Contacts CSV export. The JSON file cannot be imported yet. Another provider has to convert it; this page describes every field it needs for that. Questions: privacy@silentpixel.net.