{"info":{"_postman_id":"904dcac4-fb39-458d-a91f-ef1eded29a00","name":"LinesVerify API","description":"

WhatsApp phone-ownership verification API.

\n

Authenticate every call with your application API key (sk_app_...) as a Bearer token. Set it once in the appApiKey collection variable.

\n

Base URL: https://linesverify.com

\n

Typical flow:

\n
    \n
  1. Start a verification — your server calls POST /v1/verifications. The user receives a WhatsApp prompt.
    2. \n
  2. Poll status (optional) — GET /v1/verifications/{id}/status until it is verified.
    3. \n
  3. Confirm — POST /v1/verifications/confirm to get the final signed result server-side.
    4. \n
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"53402286","collectionId":"904dcac4-fb39-458d-a91f-ef1eded29a00","publishedId":"2sBXwyG6sL","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-06-27T04:01:18.000Z"},"item":[{"name":"Start verification","event":[{"listen":"test","script":{"type":"text/javascript","exec":["var j = pm.response.json();","if (j && j.id) {"," pm.collectionVariables.set('verificationId', j.id);"," console.log('Saved verificationId =', j.id);","}","pm.test('got verification id', function(){ pm.expect(j.id).to.be.a('string'); });"],"id":"fb11f572-9a72-495b-9fef-fd686887b021"}}],"id":"f95be4c9-46c9-4c58-b3fd-4e087f322b6a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"phone\": \"+919876543210\",\n \"method\": \"whatsapp\"\n}","options":{"raw":{"language":"json"}}},"url":"https://linesverify.com/v1/verifications","description":"

Start a WhatsApp phone verification. Returns an id, a whatsapp_url the user taps, and verify_url (hosted screen). method is optional and defaults to whatsapp. Use whatsapp_link to have us send the user a link instead.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"904dcac4-fb39-458d-a91f-ef1eded29a00","id":"904dcac4-fb39-458d-a91f-ef1eded29a00","name":"LinesVerify API","type":"collection"}},"urlObject":{"path":["v1","verifications"],"host":["https://linesverify.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"f95be4c9-46c9-4c58-b3fd-4e087f322b6a"},{"name":"Get verification status","id":"da57ccde-aef5-45c4-99c3-16d7405a16cb","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://linesverify.com/v1/verifications//status","description":"

Poll the current status of a verification: pending | sent | verified | rejected | expired.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"904dcac4-fb39-458d-a91f-ef1eded29a00","id":"904dcac4-fb39-458d-a91f-ef1eded29a00","name":"LinesVerify API","type":"collection"}},"urlObject":{"path":["v1","verifications","","status"],"host":["https://linesverify.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"da57ccde-aef5-45c4-99c3-16d7405a16cb"},{"name":"Confirm verification","id":"82aa5d85-aadf-4bd6-9fff-1820268b3f81","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"verification_id\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://linesverify.com/v1/verifications/confirm","description":"

Your SERVER confirms the final result. Pass verification_id (or the token from the callback). Returns {verified:true, id, phone, metadata} once and marks it consumed.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"904dcac4-fb39-458d-a91f-ef1eded29a00","id":"904dcac4-fb39-458d-a91f-ef1eded29a00","name":"LinesVerify API","type":"collection"}},"urlObject":{"path":["v1","verifications","confirm"],"host":["https://linesverify.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"82aa5d85-aadf-4bd6-9fff-1820268b3f81"},{"name":"Approve (link flow only)","id":"9f2fd73d-d165-43db-b5d9-1315f2e2e690","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://linesverify.com/v1/verifications//approve","description":"

Only for the whatsapp_link method — approve the verification from the hosted screen.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"904dcac4-fb39-458d-a91f-ef1eded29a00","id":"904dcac4-fb39-458d-a91f-ef1eded29a00","name":"LinesVerify API","type":"collection"}},"urlObject":{"path":["v1","verifications","","approve"],"host":["https://linesverify.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"9f2fd73d-d165-43db-b5d9-1315f2e2e690"},{"name":"Reject (link flow only)","id":"2f2453e0-b591-45b3-ba96-3364dfec2d5a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"url":"https://linesverify.com/v1/verifications//reject","description":"

Only for the whatsapp_link method — reject the verification.

\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"904dcac4-fb39-458d-a91f-ef1eded29a00","id":"904dcac4-fb39-458d-a91f-ef1eded29a00","name":"LinesVerify API","type":"collection"}},"urlObject":{"path":["v1","verifications","","reject"],"host":["https://linesverify.com"],"query":[],"variable":[]}},"response":[],"_postman_id":"2f2453e0-b591-45b3-ba96-3364dfec2d5a"},{"name":"New Request","id":"36c4e17b-d5c6-4e4b-a147-b6f9aad3f302","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]},"isInherited":true,"source":{"_postman_id":"904dcac4-fb39-458d-a91f-ef1eded29a00","id":"904dcac4-fb39-458d-a91f-ef1eded29a00","name":"LinesVerify API","type":"collection"}},"urlObject":{"query":[],"variable":[]},"url":""},"response":[],"_postman_id":"36c4e17b-d5c6-4e4b-a147-b6f9aad3f302"}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":""}]}},"event":[{"listen":"prerequest","script":{"id":"6456645f-748b-4dd8-92a0-dc1c67be41f4","type":"text/javascript","packages":{},"requests":{},"exec":[""]}},{"listen":"test","script":{"id":"78a1c4dd-4469-4512-8f01-c036b77cff79","type":"text/javascript","packages":{},"requests":{},"exec":[""]}}],"variable":[{"key":"baseUrl","value":"https://linesverify.com"},{"key":"verificationId","value":""},{"key":"appApiKey","value":""}]}