Number masking

Let two people call each other through your number without seeing each other's real numbers.

For deliveries, marketplaces, cabs and services: a customer and a delivery partner, a buyer and a seller. Make a session for the two of them on one of your Twilio or Vobiz numbers (the proxy number). While it lasts, when either one calls the proxy number they are put through to the other, who sees the proxy number. Anyone else who calls the number gets its agent as usual. Your provider charges for the calls as usual.

Make a session

POST

/v1/masking/sessions

Field	Type	Description
`connectionId`required	string	The proxy number: one of your phone numbers (its id).
`parties`required	string[]	The two people's numbers. A 10-digit number is taken as Indian.
`ttlMinutes`	number	How long it lasts: 5 minutes to 7 days, a day by default.
`label`	string	Your own reference, such as `order A17`.

curl -X POST https://lipivo.com/v1/masking/sessions \
  -H "x-api-key: $LIPIVO_API_KEY" -H "content-type: application/json" \
  -d '{"connectionId": "…", "parties": ["+919811111111", "+919822222222"], "ttlMinutes": 120}'

The answer is {"session": {"id": "msk_…", "proxyNumber": "+91…", "expiresAt": "…"}}. Tell both people to call the proxy number. A number can be in one active session per proxy number at a time (otherwise 409): use more proxy numbers for more sessions at once.

List and close

Request	What it does
`GET /v1/masking/sessions`	Your active sessions.
`DELETE /v1/masking/sessions/{id}`	End a session now, for example once the order is delivered.

← Verify (one-time codes)Website widget →