vCard to JSON
Parse a vCard (.vcf) file into JSON contacts.
POST
1 credit
/v1/convert/vcard-to-json
curl -X POST "https://convert.toolkitapi.io/v1/convert/vcard-to-json" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:Alice Example\nEMAIL:[email protected]\nTEL:+1-555-0100\nEND:VCARD"}'
import httpx
resp = httpx.post(
"https://convert.toolkitapi.io/v1/convert/vcard-to-json",
json={"vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:Alice Example\nEMAIL:[email protected]\nTEL:+1-555-0100\nEND:VCARD"},
)
print(resp.json())const resp = await fetch("https://convert.toolkitapi.io/v1/convert/vcard-to-json", {
method: "POST",
headers: {
"Content-Type": "application/json",
},
body: JSON.stringify({"vcard": "BEGIN:VCARD\nVERSION:3.0\nFN:Alice Example\nEMAIL:[email protected]\nTEL:+1-555-0100\nEND:VCARD"}),
});
const data = await resp.json();
console.log(data);# See curl example
Response
200 OK
{
"contacts": [
{"fn": "Alice Example", "email": "[email protected]", "tel": "+1-555-0100"}
],
"count": 1
}Description
Parse a vCard (.vcf) file into JSON contacts.
How to Use
1
1. POST a JSON body with `vcard` (inline string) or `url`.
2
2. Read `contacts[]` and `count` from the response.
About This Tool
Parses a vCard (`.vcf`) string into a JSON array of contact objects. Each contact's fields — name, emails, phone numbers, addresses, organization, etc. — become keys in a JSON object. Multi-contact `.vcf` files are parsed in full.
Supports vCard 3.0 and 4.0. Uses the `vobject` library internally.
Why Use This Tool
- Address-book import — Parse `.vcf` exports from iOS/macOS/Outlook
- CRM ingestion — Load contact files into a CRM's JSON-based API
- Deduplication — Compare large vCard libraries as JSON
- Bulk editing — Edit contacts programmatically before regenerating vCard
Frequently Asked Questions
vCard 3.0 and 4.0?
Both are supported.
Are multi-value fields preserved?
Yes — a contact with multiple emails/phones returns them as arrays.
What about inline photos (`PHOTO`)?
Inline photos are returned as base64 strings under the `photo` key.
Start using vCard to JSON now
Get your free API key and make your first request in under a minute.