{ "info": { "_postman_id": "12f4ed53-fc8c-4f33-8447-b88556c469b1", "name": "Datagma API", "description": "All routes live-tested against gateway.datagma.net on 2026-08-04 with a real production key. ✅ = verified working, ⚠️ = works but has caveats (see description), ❌ = confirmed broken server-side. Replaces the collection previously shipped alongside https://datagmaapi.readme.io — that one had 5 dead paths, all corrected here. See the companion doc for full detail on every finding.\n\nAuth: every request is a GET with `apiId` as a query param — no Authorization header. Set the `apiId` collection variable once and every request picks it up.", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "_exporter_id": "37771692" }, "item": [ { "name": "Account", "item": [ { "name": "Get Credit Balance", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/mine?apiId={{apiId}}", "host": [ "{{baseUrl}}" ], "path": [ "v1", "mine" ], "query": [ { "key": "apiId", "value": "{{apiId}}" } ] }, "description": "Returns account info + current credit balance. Free to call, no credit deducted. Corrected path — the old collection called this `/v1/getCredit`, which 404s (live-tested 2026-08-04); the real path is `/v1/mine`. Also note: this must be called against the `/api/ingress` base like every other endpoint — `/api/credit/v1/mine` returns a different, inconsistent error shape." }, "response": [] } ] }, { "name": "Company enrichment", "item": [ { "name": "Enrich by LinkedIn URL", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v2/full?apiId={{apiId}}&data=https://www.linkedin.com/company/salesforce/&companyPremium=true", "host": [ "{{baseUrl}}" ], "path": [ "v2", "full" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "data", "value": "https://www.linkedin.com/company/salesforce/" }, { "key": "companyPremium", "value": "true" } ] }, "description": "Most accurate input for person enrichment. `personFull=true` adds about/experience/education/certifications/languages/posts/groups." }, "response": [] }, { "name": "Enrich by Domain", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v2/full?apiId={{apiId}}&data=salesforce.com&companyPremium=true", "host": [ "{{baseUrl}}" ], "path": [ "v2", "full" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "data", "value": "salesforce.com" }, { "key": "companyPremium", "value": "true" } ] }, "description": "companyPremium (headcount, industry, HQ, website...) + companyFull (funding rounds, traffic rank, IPO info...) — same price combined, response just slower." }, "response": [] }, { "name": "Website Tech Stack", "request": { "method": "GET", "header": [ { "key": "accept", "value": "*/*" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v4/tech-stack?apiId={{apiId}}&domain=ldlc.com", "host": [ "{{baseUrl}}" ], "path": [ "v4", "tech-stack" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "domain", "value": "ldlc.com" } ] } }, "response": [] }, { "name": "Website Traffic", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v4/website-traffic?apiId={{apiId}}&domain=salesforce.com", "host": [ "{{baseUrl}}" ], "path": [ "v4", "website-traffic" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "domain", "value": "salesforce.com" } ] } }, "response": [] }, { "name": "Fundings", "request": { "method": "GET", "header": [ { "key": "Content-Type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v4/funding?apiId={{apiId}}&domain=salesforce.com", "host": [ "{{baseUrl}}" ], "path": [ "v4", "funding" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "domain", "value": "salesforce.com" } ] } }, "response": [] }, { "name": "Siren number finder", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v4/siren-company-finder?apiId={{apiId}}&domain=septodont.fr&companyName=&companyLinkedinUrl=&companyLinkedinSalesNavUrl=&companyLinkedinId=&companyLinkedinSalesNavId=", "host": [ "{{baseUrl}}" ], "path": [ "v4", "siren-company-finder" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "domain", "value": "septodont.fr" }, { "key": "companyName", "value": "" }, { "key": "companyLinkedinUrl", "value": "" }, { "key": "companyLinkedinSalesNavUrl", "value": "" }, { "key": "companyLinkedinId", "value": "" }, { "key": "companyLinkedinSalesNavId", "value": "" } ] } }, "response": [] }, { "name": "French siren", "request": { "method": "GET", "header": [] }, "response": [] }, { "name": "New Request", "request": { "method": "GET", "header": [ { "key": "accept", "value": "*/*" }, { "key": "content-type", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/v4/tech-stack?apiId={{apiId}}&domain=ldlc.com", "host": [ "{{baseUrl}}" ], "path": [ "v4", "tech-stack" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "domain", "value": "ldlc.com" } ] } }, "response": [] } ] }, { "name": "Contact enrichment", "item": [ { "name": "Real Time Contact Enrichment", "request": { "method": "GET", "header": [] }, "response": [] }, { "name": "Enrich by LinkedIn URL (database)", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v2/full?apiId={{apiId}}&data=https://www.linkedin.com/in/dnicolas&personFull=true", "host": [ "{{baseUrl}}" ], "path": [ "v2", "full" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "data", "value": "https://www.linkedin.com/in/dnicolas" }, { "key": "personFull", "value": "true" } ] }, "description": "Most accurate input for person enrichment. `personFull=true` adds about/experience/education/certifications/languages/posts/groups." }, "response": [] }, { "name": "Enrich by Name + Company (database)", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v2/full?apiId={{apiId}}&data=Datagma&fullName=Raphael Azot&phoneFull=true", "host": [ "{{baseUrl}}" ], "path": [ "v2", "full" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "data", "value": "Datagma" }, { "key": "fullName", "value": "Raphael Azot" }, { "key": "phoneFull", "value": "true" } ] }, "description": "`data` is ALWAYS required, even for a name+company lookup. The old collection's \"Enrich Person (First+Last+Company)\" example sent only firstName/lastName/company with no `data` — live-tested 2026-08-04, that returns {\"code\":3,\"message\":\"data field must have value\"}. Put the company name/domain in `data`, use fullName/firstName/lastName as a disambiguation hint on top." }, "response": [] }, { "name": "Enrich by Email", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v2/full?apiId={{apiId}}&data=sylvain@enrich-crm.com&fullName=Sylvain Charmet", "host": [ "{{baseUrl}}" ], "path": [ "v2", "full" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "companyPremium", "value": "true", "disabled": true }, { "key": "data", "value": "sylvain@enrich-crm.com" }, { "key": "fullName", "value": "Sylvain Charmet" } ] }, "description": "⚠️ A bare email with no `fullName` can resolve to the WRONG person — live-tested 2026-08-04, a bare-email lookup returned a real but unrelated profile (companyConfidence: 0.25). Adding fullName raised the confidence score but did not fully fix the mismatch on that test case. Always pass fullName alongside a bare email, and check personConfidenceScore/companyConfidence before trusting the result." }, "response": [] } ] }, { "name": "Find Email", "item": [ { "name": "Find Business Email", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v8/findEmail?apiId={{apiId}}&fullName=Raphael Azot&company=Datagma&linkedInSlug=&firstName=Raphael&lastName=Azot", "host": [ "{{baseUrl}}" ], "path": [ "v8", "findEmail" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "fullName", "value": "Raphael Azot" }, { "key": "company", "value": "Datagma" }, { "key": "linkedInSlug", "value": "" }, { "key": "firstName", "value": "Raphael", "type": "text" }, { "key": "lastName", "value": "Azot", "type": "text" } ] }, "description": "Currently-documented shape on the raw API reference. Richer payload than v6 (mailboxQuotaExceeded, possibleTrap, greylisted, smtpProvider, mxRecord, currentCredit...). `linkedInSlug` (person's or company's LinkedIn URL) improves match rate ~20%+ when you don't have a domain. Recommended for new integrations." }, "response": [] } ] }, { "name": "Job Change Detection", "item": [ { "name": "Check Job Change", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v4/update?apiId={{apiId}}&fullName=Full Name&companyName=Company", "host": [ "{{baseUrl}}" ], "path": [ "v4", "update" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "fullName", "value": "Full Name" }, { "key": "companyName", "value": "Company" }, { "key": "jobTitle", "value": "", "disabled": true } ] }, "description": "Checks in real time whether a contact still works at the company you have on file. Beta, works essentially in France/Spain/Italy/Germany per Datagma's docs (worth reconfirming coverage with Datagma). Optional jobTitle disambiguates when more than one person shares that name at that company." }, "response": [] } ] }, { "name": "Find People", "item": [] }, { "name": "Phone Finder", "item": [ { "name": "Find Phone by LinkedIn url", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/search?apiId={{apiId}}&username=https://linkedin.com/in/sylvain159&minimumMatch=1", "host": [ "{{baseUrl}}" ], "path": [ "v1", "search" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "username", "value": "https://linkedin.com/in/sylvain159" }, { "key": "minimumMatch", "value": "1" } ] } }, "response": [] }, { "name": "Find Phone by Email", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/search?apiId={{apiId}}&email=s.charmet@gmail.com&minimumMatch=1", "host": [ "{{baseUrl}}" ], "path": [ "v1", "search" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "email", "value": "s.charmet@gmail.com" }, { "key": "minimumMatch", "value": "1" } ] }, "description": "⚠️ Send both username + email when available — Datagma waterfalls automatically for the best match rate. Live-tested 2026-08-04 on a plan:\"0\" test account: every call returned {\"code\":7,\"message\":\"No permission search people who have data: ...\"}, 0 credits charged. Not confirmed whether this is plan-gated (paid tier required) or account-specific — verify on your own key before relying on it. Note: the WhatsApp-check param here is `whatsapp_check` (underscore), NOT the same spelling as /v2/full's `whatsappCheck` (camelCase)." }, "response": [] }, { "name": "Find Phone by Full Name + Company Name/Domain", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v2/full?apiId={{apiId}}&data=enrich-crm.com&fullName=Sylvain Charmet&firstName=Sylvain&lastName=Charmet&phoneFull=true", "host": [ "{{baseUrl}}" ], "path": [ "v2", "full" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "data", "value": "enrich-crm.com" }, { "key": "fullName", "value": "Sylvain Charmet" }, { "key": "firstName", "value": "Sylvain" }, { "key": "lastName", "value": "Charmet" }, { "key": "phoneFull", "value": "true" } ] } }, "response": [] }, { "name": "Find Phone by full name + country", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/search?apiId={{apiId}}&country=FR&whatsappCheck=true&firstName=sylvain&lastName=charmet", "host": [ "{{baseUrl}}" ], "path": [ "v1", "search" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "country", "value": "FR" }, { "key": "whatsappCheck", "value": "true" }, { "key": "firstName", "value": "sylvain" }, { "key": "lastName", "value": "charmet" } ] } }, "response": [] }, { "name": "Reverse Phone Lookup", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/reverse_phone_lookup?apiId={{apiId}}&code=33&number=665409047", "host": [ "{{baseUrl}}" ], "path": [ "v1", "reverse_phone_lookup" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "code", "value": "33" }, { "key": "number", "value": "665409047" } ] }, "description": "Corrected path — the old collection called this `/v1/searchByPhone?phone=`, which 404s (live-tested 2026-08-04). Real path takes separate `code` (country code, with +) and `number` params, not one combined `phone` param." }, "response": [] } ] }, { "name": "Reverse Lookup", "item": [ { "name": "Reverse Email (personal, outside EU)", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/reverse_email?apiId={{apiId}}&email=john.smith@gmail.com", "host": [ "{{baseUrl}}" ], "path": [ "v1", "reverse_email" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "email", "value": "john.smith@gmail.com" } ] }, "description": "For personal email addresses outside the EU — for professional/work emails use /v2/full instead. Corrected path — the old collection called this `/v1/searchByEmail`, which 404s (live-tested 2026-08-04). Real path is `/v1/reverse_email`." }, "response": [] } ] }, { "name": "Twitter / X", "item": [ { "name": "Get Twitter Username by LinkedIn", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/twitter/by_username?apiId={{apiId}}&data=linkedin.com/in/jamie-martin-2b8a761a", "host": [ "{{baseUrl}}" ], "path": [ "v1", "twitter", "by_username" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "data", "value": "linkedin.com/in/jamie-martin-2b8a761a" } ] }, "description": "Corrected path — the old collection called this `/v1/getTwitter`, which 404s. But even at the real path, this is ❌ CONFIRMED BROKEN as of 2026-08-04: 3 live calls with 3 different `linkedin` values (incl. a nonsense/nonexistent slug) all returned the exact same unrelated stale record. The endpoint returns \"status\":\"OK\" and appears to just ignore the `linkedin` param entirely. Do not rely on this until Datagma fixes it server-side. (The `username=` param path was tested separately and correctly returns not-found for a bad username, so the bug is isolated to the `linkedin` param.)" }, "response": [] }, { "name": "Get Twitter username by Email", "request": { "method": "GET", "header": [], "url": { "raw": "{{baseUrl}}/v1/twitter/by_email?apiId={{apiId}}&email=6scully@comcast.net", "host": [ "{{baseUrl}}" ], "path": [ "v1", "twitter", "by_email" ], "query": [ { "key": "apiId", "value": "{{apiId}}" }, { "key": "email", "value": "6scully@comcast.net" } ] }, "description": "Corrected path — the old collection called this `/v1/getTwitterByEmail`, which 404s (live-tested 2026-08-04). Real path is `/v1/twitter/by_email`. Route confirmed reachable and working; just no match on generic test emails." }, "response": [] } ] } ], "event": [ { "listen": "prerequest", "script": { "type": "text/javascript", "packages": {}, "requests": {}, "exec": [ "" ] } }, { "listen": "test", "script": { "type": "text/javascript", "packages": {}, "requests": {}, "exec": [ "" ] } } ], "variable": [ { "key": "baseUrl", "value": "https://gateway.datagma.net/api/ingress" }, { "key": "apiId", "value": "YOUR_API_KEY" } ] }